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About This Manual 


Who should use this manual... 


This manual provides the information that IBM service representatives 
need to perform program support services on System/36 programming 
and program products for which they are responsible. Information in this 
manual defines the general programming architecture of System/36. This 
information is at a more general level than information traditionally 
presented in program logic manuals. This manual should help you to 
quickly recall major functions of the System/36 programming you must 
support. It is intended to help you find the failing function or subfunction 
so that you can report the problem via an APAR. 


To use this manual effectively, you should have completed either 
System/36 program support training or System/36 support-level 
CE/CSR training. 


About This Manual vii 
This document contains restricted materials of IBM. LY21-0590-4 
©Copyright IBM Corp. 1983, 1984, 1985, 1986 


vill 


How this manual is arranged... 


« Sections 1, 2, and 4: The introduction, system function/control flow, 
and directory sections help you recall major SSP functions. These 
sections enable you to provide on-site assistance to customers or 
other IBM personnel for circumventing programming problems. 


« Section 3: The SSP programming interface section helps you isolate 
problems in SSP programming from problems in other |BM-supplied 
main storage or control storage programming. 


« Appendix A: The data communications protocols help you diagnose 
problems in |BM-supplied data communications programming 
features. 


« Appendix B: The programming language directory provides reference 
information that you can use to isolate problems in the IBM-supplied 
compiler modules and execution-time subroutines from possible 
problems in user-supplied source code. 


¢ Appendix C: The program product utilities directory provides reference 
information that you can use to isolate problems in the IBM-supplied 
program product utilities modules from possible problems in 
user-supplied source code. 


This manual assumes that almost all of your emergency work will involve 
the SSP programming. With customers becoming more and more 
dependent on online data to make minute-by-minute business decisions, 
SSP programming failures can be almost as catastrophic as hardware 
failures. Therefore, most of the information in this manual relates to the 
SSP portion of the System/36 programming. This manual places less 
emphasis on documenting IBM utility program products and languages 
because problems involving these products, whether valid or invalid, are 
usually dependent on the customer's source code. Thus problems 
involving these products can usually be temporarily circumvented by 
changing the source code or OCL. 
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If you need more information. . . 


The chart below shows all program service documentation available for 
System /36: 


IBM System/36 System 
Data Areas 
LY21-0592 


® Data Areas 
@ System Support Information 
@ Numeric Conversion Aids 


IBM System/36 Program IBM System/36 Control Storage 
Service Information Service Information 
LY21-0590 LY31-0650 


IBM System/36 Program Problem 
Diagnosis and Diagnostic Aids 
SY21-0593 


Function/Component Function 


e System Start Function ® Control Storage IPL 
® Command Processing Function @ Main Storage to Control 
® Job Start Function Storage Interface 
® Job Execution Function Main Storage Task Management 
® Job Termination Function Control Storage Processor Support 
® System Services Function Main Storage Management 
® Diagnostic Aids Function Main Storage Contents Management 
@ System Utilities Function Main Storage Resource Management 
® Data Communications Function Input/Output Support 
® SSP-ICF Function Error Recovery and Logging 
® SSP Programming Interfaces Internal Diagnostics 
® Data Communications Line 
Protocols 
® Programming Language Directory 
@ Utilities Program Product 
Directory 


Program Problem Diagnosis 
Diagnostic Aids 

- Service Aids 

- Troubleshooting Aids 

- Microinstruction Formats 


$0590153-3 
In addition to the other service manuals, you may need some or all of the 
following System/36 information while using this manual: 

e Functions Reference Manual, SA21-9436 

« System Reference, SC21-9020 

« System Messages, SC21-7938 

« Changing Your System Configuration, S$C21-9052 

e« /nteractive Communications Feature: Reference, SC21-7910 

¢ Multiple Session Remote Job Entry Guide, SC21-7909 

¢ 3270 Device Emulation Guide, SC21-7912 

e Overlay Linkage Editor Guide, SC21-9041 


e Programming with Assembler, SC21-7908 
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e Programming with RPG //, SC21-9006 

e Programming with COBOL, SC21-9007 

e Programming with BASIC, SC21-9003 

e Programming with FORTRAN IV, SC21-9005 
¢« Sort Guide, SC21-7903 

« Work Station Utility Guide, SC21-7905 

¢« Data File Utility Guide, SC21-7900 

« Source Entry Utility Guide, SC21-7901 


¢« Creating Displays: Screen Design Aid and System Support Program, 
$C21-7902 


« /deographic Sort Guide, SCO9-1054 
¢ Character Generator Utility Guide, SCOQ9-1055 
e Communications and Systems Management Guide, SC21-8010 


« Distributed Data Management Guide, SC21-8011 


How this manual has changed. . . 


Changes and additions have been made to support the following Release 5 
enhancements: Source distributed data management (SDDM), Release 3 and 
Release 4, and Release 5 target distributed data management (TDDM) mainline, 
Release 3 and Release 4 TDDM VTOC extract, DDM trace (SDDM and TDDM), 
disk copy record mode, network resource directory (NRD) LISTNRD utility, 
folder management services (FMS) utility, SNA-to-local area network (LAN) 
posting, multiline communications attachment/eight line communications 
attachment (MLCA/ELCA), remote work station (RWS) support subfunction, 
support subfunction for the LAN, SSP-ICF function, SSP-ICF advanced 
peer-to-peer networking (APPN), and the personal computer support 
subsystem. Miscellaneous changes and additions have also been made 
throughout the manual. 
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ACTLU 
ACTPU 
AFA 
APAR 
APPC 


APPN 
AQE 
ATR 


BSC 
BSCEL 


BUB 


C&SM 
C/SNA 
CE/CSR 


CFB 
CICS 
CCP 
CNOS 
config 
CPI 
CQE 
CUB 


DACTLU 


DACTPU 


DCE 


DDM 
DFA 
DFC 


DISC 
DSNX 
DSX 
DTE 
DTF 
DUB 


EOF 
EOV 
ERAP 
EXTN 


FAB 
FMS 
FSB 
F1 
FS 


activate logical unit 

activate physical unit 

active format-1 area 

authorized program analysis report 


advanced program-to-program communications 


(SSP-ICF subsystem) 

advanced peer-to-peer network 
allocation queue element 
address translation register 


binary synchronous communications 
binary synchronous communications 
equivalence link 

binary synchronous unit block 


Communications and Systems Management 
combined SNA 

customer engineer/customer service 
representative 

command function block 

customer information control system 
communications control program 
change number of sessions (command) 
configuration 

characters per inch 
console/subconsole queue element 
controller (RWS) unit block 


deactivate logical unit 

deactivate physical unit 

data communications equipment or X.25 data 
Circuit terminating equipment 

distributed data manager 

Dump File Analysis (utility) 

data flow control (a major group of SNA 
components that correlates requests and 
responses between SNA partners) 
disconnect command 

distributed systems node executive 
distributed systems executive 

data terminal equipment 

define the file (control block) 

device unit block (includes TUBs and PUBs) 


end of file 

end of volume 

error recording analysis procedure 

(task) ideographic character processing task 


file access block (for file subsystem processor) 
folder management services 

file specification block 

format 1 

format 5 


List of Abbreviations and Acronyms 


HDR1 
HDR2 


IGC 
IMS 
lIOCH 
lIOB 
lOS 
IT 


JCB 


LCB 
LCS 
LPI 


MBB 
MCR 
MIC 
MLCA/ 
ELCA 
MSRJE 


NEL 
NMVT 


NRD 
NR-NS 
NSI 
NUPD 


op code 


PB 
PSDN 
PSR 
PTF 
PVC 
PUB 


RB 
RIB 
RJE 
RRN 
RWS 


SABM 
SDDM 
SDLC 
SLCA 
SMF 
SNA 
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tape header label 1 
tape header label 2 


ideographic character 

information management system 

|/O control handler (in control storage) 
I/O block 

|/O supervisor (in control storage) 
intermediate text (in BASIC) 


job control block 


library control block 
library control sector 
lines per inch 


MSRJE BSC block 

(1255) magnetic (ink) character reader 
message identification code 

multiline communications attachment/eight line 
communications attachment 

Multiple Session Remote Job Entry feature 


NRD entry lock 

network management vector transport 
(common data structure used in network 
problem management) 

network resource directory 

SDLC number received-number sent counts 
next Sequential instruction 


operation code 


program block 

packet switched data network 
program Support representative 
program temporary fix 
permanent virtual circuit 
printer unit block 


request block 

request indicator byte 
remote job entry 
relative record number 
remote work station 


set asynchronous balance mode 
source distributed data management 
synchronous data link control 

single line communications attachment 
System Measurement Facility 
Systems Network Architecture 


List of Abbreviations and Acronyms 


xi 


SNRM 
SNUB 
SNUF 
SQs 
SSP 
SSP-ICF 


SUB 
SVC 


TB 
TDDM 
TDM 
TEB 
TUB 
TWA 
TWS 


UHLI-8 
WSOS 
X.21 
X.25 
XR1 
XR2 
XSUB 


ZPAM 


XI 


set normal response mode command 

SNA unit block 

SNA Upline Facility 

system queue space 

System Support Program Product 

System Support Program Product Interactive 
Communications Feature 

session unit block 

supervisor call (instruction) or X.25 switched 
virtual circuit 


task block 

target distributed data management 
task distributed manager 
termination exit block 

terminal unit block 

task work area 

task work space 


user-specified tape header label 1 through 8 
work station queue space 

communications type 

communications type 

index register 1 

index register 2 


translated session unit block 


sectorized data management access method 
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SYSTEM/36 PROGRAMMING 


For System/36, your job consists of supporting the 
following IBM-supplied programming: 


¢« System/36 System Support Program Product (SSP) 


« System/36 SSP-Interactive Communications Feature 
(SSP-ICF) 


¢ System/36 SSP data communications 


¢ System/36 Multiple Session Remote Job Entry 
(MSRJE) feature 


¢ System/36 3270 Device Emulation feature 
¢« Communications and Systems Management feature 
e Ideographic Generator and Sort Program Product 


¢ OFFICE/36: 
— Personal Services/36 (PS/36) 
— DisplayWrite/36 (DW/36) 
— Query/36 


e Utilities Program Product: 
— Data file utility 
— Source entry utility 
— Work station utility 
— Screen design aid 


¢« System/36 languages/compilers: 
— BASIC 
— FORTRAN 
— Assembler 
— COBOL 
— RPG Il 


Section 1: Introduction 


System/36 SSP 


Section 2: System Function/Control Flow divides the 
SSP into the following major functions: 


System start 


of & 


Command processing 


a 


Job start 
Job execution 
Job termination 


System services 


Ho & 


Diagnostic aids 
System utilities 


Data communications 


SSP-ICF 


The major function numbers (keyed 1 through i) are 
used in the ccntrol flow charts in Section 2 and in 
control flow chart references in Section 4: Directory. 
These major function numbers are also used in 

Section 3: SSP Programming Interfaces to refer to SSP 
function/control flow descriptions in Section 2. 


Control flow charts are explained under SSP Subfunction 
Descriptions in Section 2. 


Section 1: Introduction 1-1 
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Chart O shows the control flow between the major SSP 


functions: 


System Start 
Function 


e MSIPL 
e CNFIGSSP 
e CNFIGICF 


Job Start 


e Initiator 
e Allocate 
e Open 


Diagnostic Aids 
Function 


Command Processor 
Function 


Mainline 
Sign On 
Control Command 
Procedure Command 
Special Command 
Miscellaneous 
SVC Command 


SSP Utilities 
Function 


System Services 
Function 


e Librarian Facilities 
e Supervisory Functions 


Job Execution 
Function 


e Data Management 

e Print Spooling 

e Sector Data 

Management 

Keysort 

e Tape Data 
Management 

e 1255 MCR Data 
Management 

e OFFICE/36 
Support 

e Distributed Data 

Management 


SSP-ICF Function 


10) 
e DM 


e Control 


eC/SNA 

@ SSP-ICF Subsystems 
e MSRJE 

e 3270 

eC&SM 


Chart 0. System Support Program Major Function Overview Control Flow 


Job Termination 
Function 


e Close 
e Terminate 


Data Communication 
Function 


Batch BSC 
SDLC 


MLCA/ELCA 
X.21 

Autocall 

RWS 

Link Station Test 
X.25 
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Section 2: System Function/Control Flow 


SSP SUBFUNCTION DESCRIPTIONS 


In this section, each major function {1 | through i) is 
divided into subfunctions, which are described in control 
flow charts. Each control flow chart includes descriptive 
text and a diagram of the subfunction’s control flow 
from one module or routine to another. The text 
includes a numbered list of the processes performed in 
a subfunction; each process statement describes why 
control flows to a module or routine at its 
number-identified point in the chart. 


Whenever possible, the processes are listed in 
operational sequence; however, in more complex charts 
the processes are usually listed in the sequence that 
makes the chart easiest to use. When an understanding 
of the operational sequence is essential, the operational 
sequence is given in the description of the subfunction. 
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Example of a Subfunction Description 


The following example (taken from major function 2 | 
Command Processing Function) shows the parts of a 
subfunction description; the symbols used in the charts 
(arrows and boxes) are explained under Chart 


Conventions: 


Subfunction 
Name 


Description 


Processes 


Control 
Flow 
Keyed 

to 
Processes 


2-2 


Procedure Command Processing (Job Initiation) 


The command processor input router receives control when the 
operator enters a procedure, an OCL statement, or a menu option. 
The input router starts the initiator (#CIML) to process 

the procedure or OCL entered. If the operator-entered data is a 
request to attach to an active multiple requester terminal (MRT) 
task, the input router attaches the required work station(s) to 

the MRT program and updates the TB to show the additional 
work stations. 


The following procedure command processes are shown in 
Chart 2.4: 


1 Attach work station(s) to an active MRT program 
by attaching work station TUB(s) to MRT TB. 

2 Attach an initiator. 

3 If attach of initiator fails, issue error messages. 


MRT Program 


Input Router 


(#CPRT) Task Attach 
Subtask ; oF on 


Initialization Go 
(#CPSI) 


[ New Task Started ] 


Cleanup Routine Initiator Mainline 
(Chart 2.13) G 


Chart 2.4 Procedure Command Processing Control Flow 
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Notice that this example includes the subfunction name, 
a description of the subfunction, a list of the processes 
performed, and a diagram of the control flow from one 
module/routine to another. As shown in this example, 
the charts refer to modules/routines in three ways: 


e Module’s descriptive name with chart number 
reference: This type of reference indicates that the 
module is described in more detail in the referenced 
chart within this major function. In the example, a 
more detailed description of the command 
processor cleanup routines can be found in Chart 
2.13, which is also a part of Command Processing 
Function 


« Module’s descriptive name and a reverse number: 
This type of reference indicates that the module is 
part of a different major function; a more detailed 
description can be found in the referenced major 
function. References in this example show that the 
supervisor task attach transient module is part of 
the System Services Function 6 | and the initiator is 
part of the Job Start Function 3 | 


e Module’s descriptive name and module name: This 
type of reference indicates that the module is not 
described in more detail anywhere else in this 
manual; this does not mean that this is the only 
chart in which the module name is used. If more 
than one control flow path to a module exists, the 
module name will appear in more than one control 
flow chart. 


For example, the module name #CPRT may appear 
in more than one control flow chart, but the 
description will not be any more detailed than what 
is shown in this chart. The directory entry (in 
Section 4) for each module lists all charts in which 
the module name is used. 


The example also gives the following information about 
the control flow for this subfunction: 


« For all three of the listed processes, control must be 
passed through command processor resident 
mainline. 


e The command processor input router (#CPRT) 
performs the mainline (routing) functions for 
procedure command processing. 


e« If required, work stations are attached to an active 
MRT by command processor input router (#CPRT). 


e Three modules, command processor resident 
mainline, command processor input router (#CPRT), 
and supervisor task attach, are involved in starting 
the initiator. 


e Three command processor modules, command 
processor resident mainline, command processor 
input router (HCPRT), and the cleanup routine, are 
involved in processing initiation failure. 


CONTROL FLOW CHARTS 


The control flow charts in this section do not show all 
module-to-module control flow. Only modules that 
perform a distinct function in a particular process are 
shown. Hence, a module that performs a general 
function (such as SYSLOG or SYSLIST) within a major 
function may not be shown. 


The control flow charts show the principal modules or 
routines involved in the execution of a given 
subfunction, and the processes they perform for that 
subfunction. The charts are not intended to show the 
mechanics of control flow. Therefore, control flow via 
post SVC instructions is shown with little or no 
distinction from control flow via transfer SVC 
instructions. 
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Chart Conventions 


Generally, the charts show control flow from top to 
bottom, and from left to right. The following 
conventions are used to illustrate control flow in this 
manual (’n’ represents a numbered process). 


This block represents a module passing control for the purposes stated in 
n process n. 


This block shows a routine within a module receiving control to perform the 
process(s) stated in process n. 


f aaa Y This block shows a procedure passing control for the purposes stated in 
rn rocess n. 
| —> P 
1 
ee eee ) 
When process n is performed, control is passed unconditionally to the 
n receiving module, as in a transfer SVC instruction with RETURN-NO, 


WAIT-NO. 


Control is passed to the receiving module for the purposes stated in process n 

n and then returned to the next sequential instruction (NSI) of the calling module, 
as in a transfer SVC instruction with RETURN-YES. (The called module 
performs a subroutine-like function.) 


Control is passed to the receiving module for the purpose stated in process n 
and then returned to the caller at a point that is not necessarily the NSI of the 
calling module (as in subtasking, or event wait/post with WAIT-NO). 


If there is no module performing an apparent mainline function, or if there may 

n be doubt as to which module or routine (on either side of a double-headed 
arrow) is performing process n, the process number is located on the arrow, 
close to the executing module or routine. 


Arrows that enter a module or subroutine block, with dariother arrow in the 

n other side of the box, imply a through arrow. Although the module or 
subroutine may perform some process other than routing, the arrows on both 
sides of the block apply to the same numbered process (n). 
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Chart Numbering 


The charts in this section are numbered by major 
function and subfunctions within major functions. The 
first digit (1 through 10) of the chart number shows the 
major SSP function to which the subfunction belongs. 
The second digit represents a breakdown of the major 
function into subfunctions. Subsequent digits, if present, 
represent further break down of the subfunction. The 
example below explains the chart numbering system: 


Chart 10.4.3 SSP-ICF CICS Subsystem Control Flow 


This digit indicates that the control flow 
in the chart is one of several components 
in the SSP-ICF CICS subsystem. 


This digit indicates that the control 

flow in the chart is one of the subsystems 
(CICS, in this example) within the 
SSP-ICF Major Function. 


This digit indicates that the control 
flow in the chart is part of the SSP 
Major Function ff . 
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Any chart number ending with a 0 is an overview chart. 
Depending on the complexity of the component's control 
flow, the overview chart may, or may not, be 
accompanied by more detailed charts. 
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System Start Function 


The system start function consists of the subfunctions 
used to initialize the system. Although subfunctions 
within this function can be independently evoked, the 
system start function generally receives control from 
control storage IPL (CSIPL). When completed, this 
function passes control to the command processor, 
which it previously started up as a permanent task. 
Configuration is included in this major function because 
its output is closely related to main storage IPL. The 
system start function includes the following 
subfunctions: 


e Main storage initial Chart 1.1.0 
program load (MSIPL) 


e System configuration Chart 1.2.1 
¢ SSP-ICF configuration Chart 1.3.0 
2-6 


MAIN STORAGE INITIAL PROGRAM LOAD (IPL) 
SUBFUNCTION 


Main storage IPL is executed after control storage IPL 
(CSIPL) starts the main storage processor. Main storage 
IPL executes under the command processor task block 
and performs the following SSP initialization and 
housekeeping functions: 

e Initializes nucleus control blocks 

e Runs the cross-reference resolver 


« Processes work station configuration data 


« Allocates and initializes areas for display stations 
and printers 


e Initializes communications configuration data 
e Loads resident routines 

« Initiates the IPL sign-on sequence 

e Initiates the IPL start-up procedure 

e Processes IPL overrides 


Main storage initialization uses the following input during 
execution: 


« System communications area (SCA) 

« Configuration record 

« VTOC 

« Task work area (TWA) 

e Main storage nucleus 

Main storage IPL can be performed from either disk or 
diskette. When loaded from diskettes, the IPL program 
can be either from IBM-supplied diskettes, as on initial 


installation, or from user diskettes generated by the 
SAVELIBR procedure. 
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Chart 1.1.0 shows overview control flow for both disk 
and diskette IPL: 


Disk IPL Diskette IPL 


Control Storage IPL Control Storage IPL 


Main Storage Main Storage 
IPL Phase 1 IPL Phase 1 
(#MSNIP) (#MSNIP) 


Load System Library 
from Diskette 


Main Storage (#MSREL) 


IPL Phase 2 
(A4MSTWA) 


Main Storage 
IPL Phase 3 
(#MSIPL) 


IPL Post Sign-On 
(#MSCPR) 


( 
Command Processor 
Mainline 
J 
( 


(#IPLPROC) 


\ 
Start-Up Procedure | 
{ 
4 


~~ a eo aw eo oe ow om a @ aww =e == = 
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Chart 1.1.0 Main Storage IPL Overview Control Flow 
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Main Storage Initial Program Load Phase 1 


The primary function of main storage initial program load 
(IPL) phase 1 is to initialize the nucleus to a point at 
which subsequent IPL phases can operate. The first 4K 
bytes of phase 1 is called by control storage as a 
transient, but it transfers to itself to run translated; this 
moves phase 1 out of real storage so it does not 
interfere with nucleus initialization. 


If the IPL is from diskette, the remainder of the IPL 
code is read from the diskette; if the IPL is from disk, 


the remaining IPL code is read from the system library. 


The following MSIPL phase 1 processes are shown in 
Chart 1.1.1: 


1 Do the following: 


e¢ Build, assign, and queue disk and diskette error 
recovery blocks (ERBs). 


e Initialize system communications area (SCA). 


e Initialize transfer control table and #LIBRARY 
format 1. 


e Validate SSP by checking for existence and 
validity of #LIBRARY, the VTOC, the system 
files, and the configuration record. 


2 Read in remainder of IPL code from diskette or 
from disk. 


If SSP is to be loaded, if system areas are to be 
relocated, or if microcode (DIAG24) is to be loaded, 
do the following: 


e Perform additional SSP verification by checking 
system area VTOC pointers. 


¢ Prompt for user ID and password if IPL is from 
diskette (MODE-F). 


« Build, update and relocate system areas: 
#SYSHIST, #SYSTASK (in TWA), #4SYSWORK 
(Configuration record and VTOC), and 
#LIBRARY. 

¢ Load SSP from diskettes. 

¢ If requested, load microcode from diskette. 


Load nucleus-resident routines. 


Set up where-to-go (WTG) table and transfer 
control tables. 
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Control Storage IPL 


1,3 


Main Storage 
IPL Phase 1 
(ZMSNIP) 


Control Storage 


Load from Diskette 
(#MSREL) 


Cross-reference 
Resolver 


Main Storage IPL 
Phase 2 
(Chart 1.1.2) 
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Chart 1.1.1 Main Storage IPL Phase 1 Control Flow 
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Main Storage Initial Program Load Phase 2 2 Allocate and initialize all configuration records for 


local and remote work stations. 
The primary function of main storage IPL phase 2 is to 


initialize the work stations and their associated control 3 Assign and build any additional device unit blocks 
blocks, work areas and configuration records. All required. 

input/output operations for phase 2 are done using disk 

lOS (control storage). Chart 1.1.2 shows the following 4 Build TUBs and PUBs for all local work stations. 


processes performed by main storage IPL phase 2: 


5 Build device allocate table. 
1 Do the following: 


e If applicable, build communications 
configuration record and place it in the system 
configuration record. 


e Initialize the task work area (TWA). 


e Perform auto configuration by checking for new 
configuration required, using the UDT (unit 
definition table), the native printer indicator in 
the SCA, and the work station controller 
configuration tables. 


Main Storage 
IPL Phase 1 
(Chart 1.1.1) 


2,3,4| TUB Build Transient 
(4SVTUB) 


Main Storage 
IPL Phase 2 
(HMSTWA) 


Main Storage 
IPL Phase 3 
(Chart 1.1.3) 
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Chart 1.1.2 Main Storage IPL Phase 2 Control Flow 
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Main Storage Initial Program Load Phase 3 4 Assign and build subconsole TUB; clean up TUB 


chain console attributes for alternative console, if 
Phase 3 of main storage IPL (#MSIPL) performs sign-on required. 


initialization. The following MSIPL phase 3 functions are 

shown in Chart 1.1.3: 5 Log any error data passed from the control storage 
IPL. 

1 Perform mainline functions for the following: 


6 Write sign-on date to system configuration record. 
2 Perform trace and security initialization. 


3 Wait for an indication of a signed-on terminal unit 
block (TUB). 


Main Storage 
IPL Phase 2 
(Chart 1.1.2) 


Trace 
Security Initialization 
Initialization (#MSTRC) 


Command Processor 
Input Router 


Main Storage TUB Build 


IPL Phase 3 ifansient 
(#MSIPL) ov IVE! 


Control Storage 


Error Logging 
Transients 


IPL Post Sign-On 
Initialization 
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Chart 1.1.3 Main Storage IPL Phase 3 Control Flow 
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IPL Post Sign-On Initialization 4 Wait for start-up procedure completion and perform 


system file initialization. 
After IPL phase 3 has executed, the system is 


functionally ready to process user data, but all SSP 5 Attach, as required, the autocall, X.21, or the EXTN 
facilities have not been initialized and the command task. 

processor has not yet received control. IPL post sign-on 

completes the IPL initialization of SSP and passes 6 Attach remote work station tasks. 


control to the command processor. 


The following post sign-on initialization functions are 
shown in Chart 1.1.4: 


1 Set up override defaults and route for the following: 
2 Perform text management services initialization. 


3 Start IPL start-up procedure (#IPLPROC). #IPLPROC 
loads modules needed in subsequent processes. 
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Main Storage 
IPL Phase 3 
(Chart 1.1.3) 


Folder Management 
Services (FMS) IPL 
(#TMIPL) 


3! IPL Start-up 
Procedure 
IPL Post Sign-On (Chart 1.1.5) 


Initialization 
(#MSCPR) 


~~ ee ee eee 


4 System File 
Intialization 
(Chart 2.17) 


5 Task Attach 
Transient 


Remote Work 
Station 
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Chart 1.1.4 IPL Post Sign-On Control Flow 
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IPL Start-up Procedure 


The IPL start-up procedure provides for the processing of 
user-selected start-up options. The start-up procedure 
allows the user to run procedures and programs that 
require a dedicated system and/or must be run each 
time the system is started up. IPL start-up can 
conditionally run APAR, drop optional SSP support, and 
apply PTF. 


The following IPL start-up procedure processes are 
shown in Chart 1.1.5: 


1. ‘If selected, process IPL overrides. 
2 =If selected, rebuild VTOC format 1's. 
3. If selected, rebuild FMS folders. 


4 If selected, run APAR, drop optional SSP, or 
APPLYPTF. 


5 Update where-to-go (WTG) tables. 
6 If selected, run user IPL start-up procedure 1. 


7 If selected, run user IPL start-up procedure 2. 
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IPL File 
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IPL Sign-On 3 FMS Folder 
Procedure Rebuild 
(#IPLPROC) ; (Chart 1.1.7) 
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Chart 1.1.5 IPL Start-up Procedure Control Flow 
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IPL File Rebuild 4  \ssue messages for any uncorrectable problems. 


The IPL file rebuild subfunction performs reasonability 5 Verify and correct format 1’s for user indexed files. 
checks on the disk VTOC to ensure the integrity of the 
disk file format 1's. All phases of IPL file rebuild use 6 _siIf necessary, reconstruct index. 


control storage disk IOS to access the disk VTOC. 


7 ~~ Perform required keysorting. 
The following IPL file rebuild processes are shown in 
Chart 1.1.6: 8 For date chain files, ensure that all files with latest 
date have latest date indicator. 
1 Initialize for VTOC rebuild. 


9 Compress the VTOC. 
2 Initialize common area and verify correct format 1's 


for system and nonindexed user files. 10 Reset the format 5. 
3 Continue interrupted disk reorganizations. 11 Terminate this job step. 
f IPL Start-up | 
. Procedure | 
| (Chart 1.1.5) ! 
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Chart 1.1.6 IPL File Rebuild Control Flow 
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IPL Folder Management Services (FMS) Folder 
Rebuild 


IPL folder management services (FMS) folder rebuild 

checks the folders on the system to determine if any 

folders need to be rebuilt. The rebuild is performed if 
any of the following conditions exist: 


« A folder’s release level is incompatible with the 
current system release level. 


« A folder’s type header ID field does not contain the 
constant ‘TMDT’. 


« A folder is open when the system IPL is executed. 
IPL Sign-On 


Procedure 
(Chart 1.1.5) 


—— ee oe oe 


Disk VTOC 
Read/Write 


IPL FMS 
Folder 


Rebuild (#TMRBD) 


(#TMBLD) 


Rebuild Folder 


FMS Termination 


The following IPL FMS folder rebuild processes are 
shown in Chart 1.1.7: 


1 Search disk VTOC for FMS folders. 


2 Read folder header and type headers to check for 
the rebuild criteria listed above. 


3 If required, rebuild the specified folder. 
4  \ssue any required error messages for #TMRBD. 
5 Perform FMS cleanup processing. 


6 Return to caller via EXIT SVC instruction. 


FMS Common 
Subroutines 
(#TMSR) 


Get Disk 
Routine 


4 SYSLOG 
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Chart 1.1.7 IPL Folder Management Services (FMS) Folder Rebuild Control Flow 
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SYSTEM CONFIGURATION SUBFUNCTION 


System configuration is performed when the system is 
initially installed or any time a system or feature change 
requires configuration. The configuration information is 
saved in the configuration records. (See the System 
Data Areas manual for a description of the configuration 
records.) 


The user can override certain configuration options at 
IPL or alter the configuration of each work station by 
using the set configuration utility (SSETCF) or alter the 
communications configuration record by using the 
communications personalization utility (GSETCP). The 
CNFDROP procedure, which prompts for the dropping 
of optional SSP support, can be invoked by the IPL 
startup procedure. 


System configuration is initiated with the CNFIGSSP 
command following the initial loading of the base SSP 
from disk. (See the manual Performing the First System 
Configuration For Your System or the manual Changing 
Your System Configuration.) 


Chart 1.2.1 shows control flow for the following system 
configuration processes: 


1 ‘Initialize common areas and open required files for 
system configuration. 


2 Display main system configuration menu and route 
according to menu item(s) selected. 


3 Process menu item 1, How to Use CNFIGSSP, by 
displaying menu for CNFiGSSP help text. 


4 Process menu item 2, Create, Change, or Delete a 
Configuration Member. 


5 Process menu item 3, Review a Configuration, by 
displaying a configuration member or the master 
configuration record. 


6 Process menu item 4, Print Configuration, by 
formatting and printing a configuration member or 
the master configuration record. 


10 


11 


12 


Process menu item 10, Configuration Support Aids: 
e Extend a library. 
e Condense a library. 


e Calculate #LIBRARY size and main storage user 
space available. 


e Calculate the number of diskettes needed to 
save a library. 


Read in configuration member. 


Process menu item 12, Apply Changes to the Master 
Configuration Record, by applying changes from a 
configuration member. 


Process menu item 13, Rebuild the Master 
Configuration Record (Update to Next Release), 
using either a configuration member or the master 
configuration record. Refresh optional support. 


Write master configuration record and return to 
CNFIGSSP procedure to copy required SSP support 
from software distribution diskettes. 


Set flags in LDA based on configuration changes 
selected by operator. 
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Chart 1.2.1 System Configuration Main Menu Routing Control Flow 
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Create, Edit, or Delete a Configuration Member 


The following create, edit, or delete processes are 
shown in Chart 1.2.2: 


1 Process configuration menu 5, option 5 by writing 
configuration member to library and returning to 


main menu. 


2 Perform routing for menu 5 options. 


3 Process option 1, by prompting for local and remote 
work station support. 


System Configuration 
Main Menu Routing 
(Chart 1.2.1) 
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(SCNRLD) 


Configuration 
Support Aids 
(SCNAID) 


Process option 2. Prompt for and set flags in 
configuration member for changes to program 
product, SSP features, and optional SSP. 


Prompt for and set flags in configuration member for 
changes to SSP features and optional SSP. 


Select specified translate tables for BSC 3270 and 
SNA 3270 device emulation, and 3278/3279 
emulation via IBM Personal Computer. 


Process option 3, setting flags and saving values for 
changes to base SSP. 


Process option 4, saving values for TWA, VTOC, or 
history file size changes. 


Read in member; then return to support aid 
processing. 


Work Station 
Configuration Menu 
Processor 

(Chart 1.2.4) 
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Chart 1.2.2 Create, Edit, or Delete Configuration Member Control Flow 
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CNFIGSSP Print 


CNFIGSSP print provides options for printing 
information from configuration records. 


The following print function processes are shown in 
Chart 1.2.3: 


1 Display print option menu and process options 
selected: 


« Process command key 3 by returning to display 
CNFIGSSP main menu. 


¢ Display configuration member definition screen 
and process data entered. 


e Process command key 19 by exiting CNFIGSSP. 


2 Print requested documents. 


System Configuration 
Main Menu Utility 
(Chart 1.2.1) 


Configuration 
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Chart 1.2.3 CNFIGSSP Print Control Flow 
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Work Station Configuration 


Work station configuration provides prompting for all 
local and remote work station configuration. Based on 
operator responses, work station configuration modifies 
individual 64-byte work station table entries in a 


Process menu item 5, Assign Display Station Control 
(Subconsoles) for Printers. 


Process menu item 6, Change Display Station or 
Printer Work Station IDs. \f print is active, pass 
control to print module, Chart 1.2.6. 


configuration member. 


5 Process menu item 7, Change Display Station or 


The following work station configuration processes are Printer Characteristics. 


shown in Chart 1.2.4: 
6 Process menu item 8, Select the System Printer. 
1 Process menu item 1, Add or Delete Local Display 
Stations and Printers. 7 Perform initial validity checks on work station 


assignments specified on screen 28. 
2 Process menu item 4, Assign Default Printers to 


Display Stations. 


Configuration 
SSP Router 


(Chart 1.2.2) 
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Chart 1.2.4 Work Station Configuration Control Flow 
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Work Station Definition 3 Process menu item 3, Add or Delete Remote 
Controllers, Display Stations and Printers, by altering 


Work station definition modifies the configuration remote work station table entries in configuration 


records for local and remote work stations. The member. 

following work station definition processes are shown in 

Chart 1.2.4.1: 4 Process menu item 9, Add Remote Service Device 

Definition, by building remote table entry, assigning 

1 Process menu item 2, Add or Delete Remote Line controller ID of CFE, attaching printer and, if 
Characteristics, by updating remote work station line required, changing remote work station line 1 
attributes in configuration member. attributes. 

2 Process menu item 1, Add or Delete Local Display 5 Process menu item 10, Delete Remote Service 
Stations and Printers, by altering local work station Device Definition, by deleting entries made in 
table entries in configuration member. process 4 above (except line attributes). 


6 Assign local and remote work station addresses 
based on physical locations; assign work station and 
controller IDs based on default. 
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Configuration Drop Support 2 Change system configuration record based on user 


responses. 

Configuration drop support is invoked by the IPL start-up 

procedure. The procedure uses the local data area to 3 Specify support to be dropped in LDA. 
prompt for and set optional SSP features to be dropped. 

The following drop support processes are shown in 4 Remove specified library members. 
Chart 1.2.5: 


5 Reset flags based on values set in LDA. 
1 Prompt for and set user requests for SSP and 


program product to be dropped by calling each of 
the procedures required. 


f 

1 

IPL Start-up 
! Procedure 

! (Chart 1.1.5) 
X\ 
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Chart 1.2.5 Drop Support Control Flow 
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Configuration Load Support 


Configuration load support is invoked by the IPL start-up 
procedure. The procedure uses the local data area to 
prompt for and set optional SSP features to be dropped. 
The following drop support processes are shown in 
Chart 1.2.6: 


1 Load programming support based on LDA settings. 
Load SSP features based on LDA settings. 


CNFIGSSP 


) 

I 
Configuration Load | 
Program Product 
and Optional SSP ? 
Support Procedure 
(CNENGL) | 
(CNKNJ) 
(CNKNJP) | 
J 


oe as a aaa aera ewe 


Appropriate Program Product, 
SSP Features, or Optional 
SSP Load Procedures 


Chart 1.2.6 Load Support Control Flow 


2 Call individual load procedures for each program 


product, SSP feature, and optional SSP. 
3 Create specified libraries. 


4 _ Reset flags based on values set in LDA. 
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SSP-ICF CONFIGURATION SUBFUNCTION 


SSP-ICF configuration provides for the creating, editing, 
deleting, and reviewing of SSP-ICF configuration 


members. SSP-ICF configuration processes two member 


types: line member (CNICL) and subsystem member 
(CNICS). These members are contained in the current 
library. 


The SSP-ICF line configuration member defines the 
attributes of a communications line. The SSP-ICF 
subsystem configuration member defines the attributes 
of an SSP-ICF subsystem. The SSP-ICF line 
configuration member must exist before the subsystem 
configuration member for that subsystem is created. 


SSP-ICF configuration is invoked via the CNFIGICF 
procedure command. After setting the configuration 
according to prompt responses from the operator, 
SSP-ICF configuration writes the configuration member 
back to disk. The CNFIGICF procedure defines the 
configuration member in display screens by individual 
SSP-ICF subsystem, allowing the user to modify all 
SSP-ICF configurations. 


Note: For descriptions of the CNICL and CNICS (line and 


subsystem) members, refer to SSP-ICF Configuration 
Record in the System Data Areas manual. 
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The following SSP-ICF configuration overview processes 
are shown in Chart 1.3.0: 


2-28 


Initialize common areas for SSP-ICF configuration. 
Display main menu for SSP-ICF line and subsystem 
configuration and route to next menu or perform 
menu-selected function. 

Process menu item 1, Create a member. 


Process menu item 2, Edit a member. 


Process menu item 3, Create a member from an 
existing member. 


Process menu item 4, Remove a member. 
Process menu item 5, Review a member. 


If SSP-ICF Intra subsystem configuration is 
requested, process the request. 


10 


11 


12 


13 


If BSC, SNA, or asynchronous line configuration 
information is required, process the request. 


If configuration information for a BSC subsystem is 
required, process the request. 


If configuration information for an SNA subsystem 
is required, process the request. 


If configuration information for an asynchronous 
subsystem is required, process the request. 


Write the edited or new member to current library 
and return to main menu. 


Note: For descriptions of the CNICL and CNICS (line and 
subsystem) members, refer to the System Data Areas 
manual. 
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Chart 1.3.0 SSP-ICF Configuration Overview Control Flow 
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BSC/SNA/Asynchronous Line Configuration 4 If configuration is for BSC-MSRJE, display 
BSC-MSRJE screens 10.5 and 11.0 and process the 


BSC/SNA/asynchronous line configuration creates or remote system parameters. 

edits line configuration members for BSC, SNA SSP-ICF, 

or asynchronous subsystems. The following 5 If configuration is for asynchronous, display 

BSC/SNA/asynchronous line configuration processes are asynchronous screen 12.5 to define remote 

shown in Chart 1.3.1: systems. 

1 ‘If configuration is for BSC, display BSC screen 10.0 6 If configuration is for SNA, display SNA screens 
and store BSC line data in an SSP-ICF configuration 12.5 and 13.0 and process SNA remote system 
member. parameters. 


2 If configuration is for SNA, display SNA screen 12.0 7 — If configuration is for SNA and LU information is 
and store SNA line data in an SSP-ICF configuration needed, display screen 14.0, process responses, 
member. and update configuration member. 


3. If configuration is for asynchronous, display 
asynchronous screens 12.1 and 12.2 and store 
asynchronous line data in an SSP-ICF configuration 
member. 
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Chart 1.3.1 BSC/SNA Asynchronous Line Configuration Control Flow 
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BSC Subsystem Configuration 

BSC subsystem configuration creates or edits subsystem 
configuration members for BSC SSP-ICF subsystems. 
The following BSC subsystem configuration processes 
are shown in Chart 1.3.2: 


1 Display screen 22.0 and perform applicable 
subsystem configuration. 


2 Perform BSC MSRJE subsystem configuration. 

3 Perform BSC-CCP subsystem configuration. 

4 Perform BSCEL subsystem configuration. 

5 Perform BSC-CICS subsystem configuration. 

6 Perform BSC-IMS/IRSS subsystem configuration. 


7 Perform BSC 3270 subsystem configuration. 
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Chart 1.3.2 BSC Subsystem Configuration Control Flow 
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SNA Subsystem Configuration 5 Perform Finance subsystem configuration. 


SNA subsystem configuration creates or edits 6 Perform Peer subsystem configuration. 


subsystem configuration members for SNA SSP-ICF 


subsystems. The following SNA subsystem 7 Perform APPC subsystem configuration. 


configuration processes are shown in Chart 1.3.3: 


8 Perform APPN subsystem configuration. 


1 Display screen 22.0 and perform applicable 


subsystem configuration. 9 Remote location definition for APPN. 
2 Perform SNA MSRJE subsystem configuration. 10 Session group definition for APPN. 
3 Perform SNUF subsystem configuration. 11 Single session location definition for APPN. 


4 Perform SNA 3270 subsystem configuration. 


CNFIGICE Utility 
(Chart 1.3.0) 


SSP-ICF Subsystem 
Parameter Utility 
(SICFA) 


SSP-ICF Remote 
System and Location 
Configuration 
Parameters 
(SICFS and $1C30) 


APPN Subsystem 11 Single Session 
Selection Location 
Display ($1C28) Definition ($1C45) 


Session 
Remote Location Group 
Definition ($1C29A) Definition 


($1C42A) 


Session 
Group 
Parameters 
($1C43) 


Remote Location 
Parameters 
($1C30, $1C41) 


Chart 1.3.3 SNA Subsystem Configuration Control Flow 
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MSRJE Configuration 
Displays 
($1C34-37) 


SSP-ICF SNUF 
Subsystem General 
Parameters ($ICFF) 


SSP-ICF SNA 3270 
Device Parameters 
(SICFQ) 


SSP-ICF Finance 
Subsystem Location 
Parameters 

(SICFT) 


SSP-ICF Peer 
Subsystem Parameters 
(SICFN) 


SSP-ICF APPC 
Subsystem Parameters 
($1C41,$1C43) 
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Asynchronous Subsystem Configuration 


Asynchronous subsystem configuration creates or edits 
subsystem configuration members for asynchronous ICF 
subsystems. The following asynchronous subsystem 
configuration processes are shown in Chart 1.3.4: 


1. Display screen 22.0 and perform applicable 
subsystem configuration. 


2 Perform asynchronous subsystem configuration. 


3 Perform asynchronous subsystem remote system 
and location configuration. 


4 Perform asynchronous subsystem parameters 
configuration. 


CNFIGICE Utility 
(Chart 1.3.0) 


Asynchronous 


Asynchronous Remote System Asynchronous 
Subsystem and Location Subsystem 
Parameter Configuration Parameters 
Utility Parameters ($1C60) 
(SICFA) ($ICFS) 
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Chart 1.3.4 Asynchronous Subsystem Configuration Control Flow 
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Command Processing Function 


The command processing function enables the system 
operator or the display station operator to direct 
System/36 in processing tasks and controlling the 
system. 


After it initially receives control from main storage IPL 
(part of the system start function Mj), the command 
processing function ‘owns’ all display stations that have 
no other jobs running at them (idle display stations). It 
controls the system console display, subconsole displays, 
and the display screens; command key processing; and 
function key processing of all display stations that it 
owns. 


The command processing function receives control 
when an operator presses the Enter key or a command 
key, or invokes a high-level aid. If the input is a user 
menu option, the command processor retrieves the 
command text from disk and uses it as input. If the input 
is a control command or help menu option, control is 
passed to the appropriate command processor transient 
program. If the input is the name of an active MRT 
program, the command processor attaches the display 
Station to the MRT program. If input is anything other 
than those mentioned above, the command processor 
Starts an initiator El as a new task. 


The command processing function also performs the 
following miscellaneous functions: 


e Provides an error recovery interface. 


e Processes SSP-ICF procedure start requests 
received from remote systems. 


¢« Displays the sign-on display. 

¢ Processes inquiry requests. 

¢ Processes high-level aids. 

¢ Performs display station release at end of job. 


e Simulates certain control commands. 
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COMMAND PROCESSOR TASK STRUCTURE 


The command processing function is divided among 
several tasks. Two are permanent tasks attached during 
IPL, and the others are subtasks that are attached as 
required. A description of each task follows. 


Command Processor Mainline Task 


All command processor posts are first received by the 
mainline task. This task must determine the initial 
action required and ensure that conflicting command 
processing functions are not processed concurrently. 


I/O Error Processing Task 


This task receives control whenever the system requires 
some type of |/O error processing. The main storage 
processing for all 1/O errors is driven by this task. 


Functional Subtasks 


When the mainline task identifies a request for a specific 
command processor function, it attaches a subtask to 
perform all the processing required for that request. 
When the subtask is attached, the mainline task 
indicates that it is to receive a post when the subtask 
terminates. This is the way that the mainline task 
receives notification when all processing for the request 
has completed. 


Task-to-Task Communication Subtask 
This subtask is attached when the mainline task receives 


a task-to-task communication (TTC) post. For more 
information, see Chart 2.5. 
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The command processing function includes the following 
subfunctions: 


« Command processor mainline Chart 2.1 

« Sign-on Chart 2.2 

¢« Control command processing Chart 2.3.n 

e Procedure command Chart 2.4 
processing (job initiation) 

¢ High-level aids and Chart 2.5 


task-to-task communications router 


e Work station release Chart 2.6 

e« Inquiry menu option Chart 2.7 
processor 

« Miscellaneous input Chart 2.8 

« Special keys Chart 2.9 


» Command processor/work station Chart 2.10 
data management interface 
« Console display Chart 2.11 


« System request/enter and power- Chart 2.12 


on aid 
e Command processor cleanup Chart 2.13 
« 1/0 error recovery Chart 2.14 
e Display station error recovery Chart 2.15 
e Initiator command interface Chart 2.16 
- System file initiation Chart 2.17 


This document contains restricted materials of IBM. LY21-O590-4 


©Copyright IBM Corp. 1983, 1984, 1985, 1986 


COMMAND PROCESSING FUNCTION CHART 
CONVENTIONS 


The following conventions are used to illustrate control 
flow in the command processing section of this manual: 


um Transfer without return 
<em> Transfer with return 
~———> Task posting another task 
uzumzZZ> Task attaching another task 
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COMMAND PROCESSOR MAINLINE 
SUBFUNCTION 


Command processor mainline waits for events to occur 
and attaches a command processor subtask to process 
those events. 


Events that cause the mainline task to gain control are: 


e Invite op-end: An operator has pressed a command 
key or entered a command, OCL statement, or 
menu option. 


¢« Attn post: An operator has requested the inquiry 
function by pressing the Attn key. 


e EXTN character post: An operator has entered a 
request for one ideographic character. 


¢ Sys req post: An operator has pressed the System 
Request and Enter/Rec Adv key to get a sign-on 
display or to change interfaces at the system 
console or subconsole. 


¢ Task-to-task communications post: A task has 
posted the command processor task via the post 


SVC instruction. 


¢ 1/0 error: An |/O error has occurred. 
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e OCL command request: A control command issued e Subtask termination: A command processor 
from a system program is being processed. subtask has completed its processing and has 
terminated. 
¢ Power on post: An operator has powered on a 
display station. e CFB post: A task has posted the command 
processor with a command/function block (CFB). 


e SSP-ICF procedure start: An SSP-ICF subsystem 
has posted the command processor to start a 
procedure. 


ENTER KEY WITH: 


Sign-On Data —_———— Chart 2.2 
Command Data c————3 pam Chart 2.3.n 
OCL or Procedure <> eae Chart 2.4 
Inquiry Menu Option pane Chart 2.7 
MISCELLANEOUS i 
INPUT: Chart 2.8 
Command Keys 
Help Options 
User Menu Options 
Function Keys 
Subtask Initiator 
Enter K th 
aaa Ae Command Processor (#CPSI) 
Scheduler 
(4CPSC) 
OTHER SSP: 
JOBQ EOJ Command Processor JOBO Start 
Mainline a (#CCJS) 
SSP-ICF Proc. Sta (#CPML) Procedure Start 
(#CPPS) 
OCL Cmd Req. or a Chart 2.14 
Subtask Term. =. 
CFB Post IPL Command Lad 
IPLPROC Comp. ——+— pee Mainline pag Chart 2.15 
1/O Error a 


ERP Task 
(Chart 2.14) 


High-Level Aids: 
Sys Req Key 
Inq 1 Option Pnd 

High-level Help 


ATTN Key 


————i_~, 
EXTN char req. ets 


Task-to- Task 
Communication 
Router 

(#CPTC) 


Other TTC: 
Stop System Cmp 
Ready AID 

Release ————— _», 
Console/SYSLOG ——t—> 
Cancel Pending ——!—., 
MLCA/ELCA ControllerL—s 
check 


(Chart 2.5) 


a 
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Note: The mainline subfunction does not directly route control to the command processor work station interface subfunction 
(Chart 2.9), and the command processor cleanup subfunction (Chart 2.12). These subfunctions are called directly by 
command processor transients. 


Chart 2.1 Command Processor Mainline Control Flow 
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SIGN-ON SUBFUNCTION 


Sign-on establishes the interface between the display 3 


station operator and the SSP. The following sign-on 


processes are shown in Chart 2.2: 4 


1. Do the following and route for remaining control 
flow. 


e Initialize display station for commands or OCL. 


¢ Initialize display station for acquisition (standby 
mode). 


e Create job control block (JCB). 


¢  IfIPL is in progress, set time/date. 


Subtask 
Initialization 
(#CPSI) 


2 


Input Router 
(#CPRT) 


Command 
Processor 
Sign-On 
(ZCPON) 


Chart 2.2 Sign-On Control Flow 
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If requested, create test request task. 
Validate password security information. 


If library information is specified, update JCB and 
build FSB. 


If menu information is specified, set up menu 
information in JCB and TUB. 


If applicable, display the system error display. 


If applicable, display the initial screen or attach the 
sign-on procedure. 


Issue any required messages and put records to 
history file. 


Task Attach 
Transient 


Password 
Security 


Find a 
Library 
(HMAFLB) 


Menu Command 
Processor 
(#CCMU) 


System Error 
Display 
(#CPMF) 


Special Keys 
Processor 
(Chart 2.9) 


Cleanup Routine 
(Chart 2.13) 
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CONTROL COMMAND PROCESSING 
SUBFUNCTION 


Control command processing handles commands from 
display stations. Control commands do not require 
initiator functions for their processing. Charts 2.3.1 and 
2.3.2 show the control flow for the control commands. 


The chart below is a summary of the restrictions on 
control commana usage from the various display station 
types and modes of operation: 


System 
Command Display Service 
Name Station Subconsole System Console Device 


es 
PASSIGN, | 

a a ea ee Se ee! Oe Se 
|cHANGE [| Tm ew 
|consoce | mT em 

pHeP OT CT ee 

pHoLD | mT 


ee eee 
pReleASE | OL em ee 
PREPLY ] 
PRESTART | | em 
MSTARI oe Se 
|starus | ww 
pstatuse | @ | 


STOP 


@ Indicates that the command can be used from the display station when it is in the specified mode. 


@ Indicates that the full function of the command is not available to the given display station type 
and mode; for specific command function limitations, refer to the System Reference manual. 
$0590292-0 
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ASSIGN 


CANCEL 
First Operand 
CHANGE Router (#CPRS) 


CONSOLE 
HELP 


HOLD 


INFOMSG 
JOBQ 
MENU 


MODE 
Subtask 


Initialization 
(#CPSI) 


Input 
Router 
(#CPRT) 


POWER 
PRTY 


RELEASE First Operand 
Router (#CPRS) 


REPLY 


RESTART 


START First Operand 
Router (#CPRS) 


STATUS 


Beatie 


a Router (#CPRS) - 
TIME 


VARY pay 
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Chart 2.3.1 Control Command Processing Control Flow 
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CANCEL 


CHANGE 


CONSOLE 


HOLD 


RELEASE 


START / 
STOP 


JOBQ 
PRT 
SESSION 
JOBNAME 
JOBQ 
JOBS 
PRT 

ID 
COPIES 
FORMS 
PRTY 
SEP 
DEFER 
GIVE 
TAKE 
JOBQ 
PRT 
JOBQ 
PRT 
JOBQ 
PRT 
WORKSTN 
SYSTEM 
JOB 
SESSION 
SERVICE 


First 
Operand 


Router 
(#CPRS) 


Chart 2.3.2 First Operand Router Control Flow 
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STATUS 
SESSION 


JOBQ 

PRT 

WRT 
WORKSTN 
USERS 
SYSTASK Status 
COMM | Mainline 
SUBSYS (#CCSM) 
SUBSESS 
MESSAGE 
MSRJE 
LINE 
COMCNFIG 


APPC 
ALERT 


#CCSS/#CCS2 


Note: Control flow shown for the JOBQ, PRT, WORKSTN, and USERS 
parameters also applies to the equivalent parameters used 


with the STATUSF command. 


Chart 2.3.3 Status Command Control Flow 
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PROCEDURE COMMAND PROCESSING (JOB 
INITIATION) SUBFUNCTION 


The command processor input router receives control 
when the operator enters a procedure, an OCL 
statement, or a menu option. The input router starts the 
initiator (HCIML) to process the procedure or OCL 
entered. If the operator-entered data is a request to 
attach to an active multiple requester terminal (MRT) 
task, the input router attaches the required work 
station(s) to the MRT program and updates the TB to 
show the additional work stations. 


The following procedure command processes are shown 
in Chart 2.4: 


1. Attach work station(s) to an active MRT program by 
attaching work station TUB(s) to MRT TB. 


2 Attach an initiator. 


3 If attach of initiator fails, issue error messages. 


—$—> MRT Program 


Input Router 


(#CPRT) 
Subtask Initialization ees Task Attach 
(#CPSI) a 
[ New Task Started ] 


Initiator Mainline 


Cleanup Routine 


(Chart 2.13) 


$0590037-2 
Chart 2.4 Procedure Command Processing Control Flow 
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HIGH-LEVEL AIDS AND TASK-TO-TASK The following processes are shown in Chart 2.5: 
COMMUNICATIONS ROUTER SUBFUNCTION 


1 Sound the alarm for new console messages and 


When a task-to-task communications (TTC) post is look for any pended console display requests. 
received, it could indicate one or more different types of 

requests. The TTC subtask is attached by the mainline 2 Process any pended cancel job requests. 
command processor task to search for these requests by 

scanning the DUB chain, scanning the JCB chain, and 3 Start functional subtask for a request. 
checking indicator bits in the SCA. When any request is 

found, a CFB is built for the request and posted to the 4 Sys Reg key and power-on aid requests. 
mainline task so functional subtasks can be attached to 

perform the processing. Once attached, the TTC subtask 5 Attention key requests. 

remains active until no more requests have been found 

and no more new posts have been received. 6 Help key (in operator error mode) requests. 


7 Work station release requests. 

8 Stop system complete. 

9 Ready aid. 

10 Pended console display requests. 
11 Extended character requests. 

12 Error recovery aid. 


13 MLCA/ELCA controller check. 
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Command Processor 
Mainline 
(#CPML) 


Command Processor 
Scheduler 
(#CPSC) 


Subtask Sys/Req Key 


arerrenty 


Initialization Chart 2.11 
(#CPSI) 


Attn Key 
Console Light (#CPT2) 
Manager 


(#CMCI) 
High-Level Help 


Task-to-Task (#WDHH) 


Communications 
Router 
(A#CPTC) 


ERP Task 


(#SVML) Work Station Release 


(Chart 2.6) 


Cancel Job 
(#4CCCM) 


Stop System Complete 
(#CCRT) 


Ready Aid 
(#4SVWSR) 


13] WMLCA/ELCA Recovery 
(MLCT) 


Console Display 


Chart 2.11 


EXTN Task 


(#GAML) 
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Chart 2.5 High-Level Aids and Task-to-Task Communications Router Control Flow 
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WORK STATION RELEASE SUBFUNCTION 2 Attach the initiator to process the next job step 
when a requester is released from an MRT task or 


Work station release returns a work station to its when the current job step releases its requester via 
previous owner. If the previous owner was a job, work the ATTR OCL statement. 

Station release attaches the initiator to process the next 

job step; if the previous owner was the command 3 Sign off a work station if OFF OCL statement was 
processor, work station release reestablishes the processed. 


appropriate interface, based on the work station mode. 
4 lf RESTORE-NO was specified, clear all of the input 
The task-to-task communications router (#CPTC) fields on the display. 
determines that a release should be done for a work 
Station. #CPTC then posts the mainline task to create a 
new command processor subtask to perform the release. 
The following release subfunction processes are shown 
in Chart 2.6: 


1 Reestablish the command interface at end of job by 
displaying the appropriate display: 


e Command display 
e Standby display 

e Help menu 

e Status display 


e Any waiting message(s) 
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Subtask 1 Special Keys 
Processor 
(Chart 2.9) 


Initialization 
(#CPSI) 


2 Task Attach 
ZZZZZZDD Transient 


Initiator Mainline 


Work Station 
Release 


(#CPRL) 


Sign- Off 
Command 


Processor 
(#CCOF) 


Sign-On 
Display 
(#CPTS) 


Command 
Processor |/O 
Processor 
(Chart 2.10) 
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Chart 2.6 Work Station Release Control Flow 
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INQUIRY MENU OPTION PROCESSOR 
SUBFUNCTION 


The inquiry menu option processor executes when the 
operator interrupts a currently executing program by 
pressing the Attn key. When the Attn key is pressed at a 
display station where an SRT job is running, the SRT job 
is suspended. A new TUB for inquiry is built and put on 
the vertical TUB chain in place of the TUB to which the 
SRT was attached. 


When the Attn key is pressed at a display station that is 
attached to an MRT program, the MRT job is informed 
that it should not service the TUB. With the exception of 
those items listed below, processing for MRT and SRT 
inquiries is the same. 
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The following inquiry menu option processor processes 
are shown in Chart 2.7: 


1 Process menu option O: If the current interrupted 
job is an SRT, restore the previous user display and 
resume the current interrupted job. If the current 
interrupted job is an MRT, restore the previous user 
display and allow the TUB to be processed. 


2 Process menu option 1: Establish command 
interface for inquiry. 


3 Process menu option 2: If the current interrupted 
job is an SRT, perform an option 2 cancel of the 
SRT job. If the current interrupted job is an MRT, 
release the display station from the MRT job and 
continue with additional job steps. 


4 Process menu option 3: If the current interrupted 
job is an SRT, perform an option 3 cancel of the 
SRT job. If the current interrupted job is an MRT, 
release the display station from the MRT job and 
cancel any remaining job steps. 


5 Process menu option 4: Set the inquiry latch in the 
JCB and resume the current interrupted job. 


6 Process menu option 5: Display session status. 


7 Process menu option 6: Display waiting 
message(s). 


8 Process menu option 7: If the alternate interrupted 
job is an SRT, restore the previous user display for 
the alternate interrupted job and resume the 
alternate interrupted job. If the alternate interrupted 
job is an MRT, restore the previous user display for 
the alternate interrupted job and allow the TUB to 
be processed. 
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Subtask 
Initialization 
(#CPSI) 


1,2,5,8 Command 
Processor |/O 


Input Router 


(#CPRT) 
Processor 


(Chart 2.10) 
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Processor 
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Message 
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Chart 2.7 Inquiry Menu Option Processor Control Flow 
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MISCELLANEOUS INPUT SUBFUNCTION 2 Help key. 


The following input functions are shown in Chart 2.8: 3 Option from SSP help menu. 
1 Process the following input: 4 Help for a control command. 
e Command keys. 5 Enter key with DUP characters. 
e Home key. 6 Enter key without input data from console display. 
e Roll keys. 7 Enter key to end help text for sign-on display. 
e Test Request key. 8 Console command from IPL in progress display. 


e Enter key without data from a status display. 


e 1/0 error. 


Subtask 
Initialization 
(#CPSI) 


Special Keys 
Processor 


(Chart 2.9) eID NEY 


Processor 
(#CPHK) 


Help Menu 


Input Processor 
P Help Control 


Command 


(#CHIN) 
(#CPRT) (#CHLP) 


Input Router 


Dup Key 
Processor 


(#CPDK) Console 
Display 


(#CMCD) 


Help Page Back 
Transient 


(#CHPB) Sign-On 


Display 
(#CPTS) 
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Chart 2.8 Miscellaneous Input Control Flow 
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SPECIAL KEYS SUBFUNCTION 8 Command keys 5, 6, 12, 23, 24, and the Home key. 


The following functions and command keys are shown 9 Command key 8. 
in Chart 2.9: 
10 Command keys 9, 10, 15, and 16. 
1 Put up system displays after a program has released 
a display station at end of job, but the OCL 11 Command key 11. 
statement specified RESTORE-NO. 
12 Roll keys from status display. 
2 Display MSG command messages. 
13 Roll keys from help text for user menu. 
3. Restore console display after second-level text for a 
message was displayed at the system console or 14 Roll keys with SSP help active. 
subconsole. 
15 Roll keys with SSP help text active. 
4 Attach sign-on procedure. 
16 Enter key or command key 3 from help text for user 


5 Display system error display. menu. 
Process the following keys: 17 Test Request key. 
6 Command key 1. 18 Issue error messages for invalid keys. 


7 Command keys 3 and 7 from help prompt, help 
menu, or user menu. 
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Command Processor 
|/O Processor 
(Chart 2.10) 
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(#CCMX) 
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(#C PIP) System Error 


Display 
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Inquiry Menu 
Option Processor 


Page Back 
(#CPIQ) 


Processor 
(#CHPB) 


Help Menu 
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(#CHMD) Help Text 


Processor 
(#CHHT) 


Special Keys 
Processor 
(#CPSP) 


Status Mainline 


(#CCSM) Help Output 


(#CHOP) 


User Menu Help 
Text Processor 
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Help Menu Input 
Processor 
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Chart 2.9 Special Keys Control Flow 
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COMMAND PROCESSOR/WORK STATION DATA 
MANAGEMENT (WSDM) INTERFACE 
SUBFUNCTION 


The command processor/WSDM interface subfunction 
processes the requests from command processor 
routines for work station |/O operations. Callers invoke 
the command processor/WSDM interface via the 
transfer SVC instruction. The interface consists of two 
processing modules: #CPIO is the command processor 
work station |/O processor, and #CHOP is the help 
output transient. #CPIO handles save/restore requests 
and the displaying of command processor screens, user 
menus, and help text for user menus. #CHOP displays 
help menus and prompts; it also displays help text for 
help menus, prompts, and command processor screens. 
Some command processor programs call #CHOP 
directly, and others call #CPIO which determines if 
#CHOP should be called. 


The following command processor/WSDM interface 
processes are shown in Chart 2.10: 


1 Process caller request by building system parameter 
list for WSDM. 


2 If help menu or help prompt is displayed, determine 
next format to be displayed. 


3 Perform work station |/O operations requested by 
H#CPIO or #CHOP. 


Command Processor Work Station 
Work Station |/O Data Management 
Processor a | 

(#CPIO) 


Calling Command 
Processor Routine 


Help Output Work Station 
Processor Data Management 


(#CHOP) 4 | 


Calling Command 
Processor Routine 
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Chart 2.10 Command Processor |/O-WSDM Interface Control Flow 
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CONSOLE DISPLAY SUBFUNCTION 


The console display subfunction retrieves messages to 
be displayed at a console or subconsole and performs 
the necessary operations to show them at the console 
display. These messages may have been issued by 
using the MSG command or // MSG OCL statement. 
They may have also been issued through SYSLOG, I/O 
error recovery, or any other function that uses a console 
queue element (CQE). 


Calling Command Console /Subconsole 


Processor Routine Display 
(#CMCD) 


Chart 2.11 Consol Display Control Flow 
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The following console display processes are shown in 
Chart 2.11: 


Determine if a message can be issued and do the 
following for each message: 


e Retrieve the message text and place it into a 
WSDM buffer. 


e Determine which lines to roll off the screen to 
make room for the new message. 


e Update the console screen image on disk. 
Roll the screen and display the new messages. 


Place asterisks next to messages that have been 
responded to. 


Retrieve the text for messages sent via the MSG 
command. 


Turn off the message light if no more messages are 
waiting to be displayed. 


Issue message if some resource is not available. 


Work Station 
Data Management 


Message Reply 
Marker 
(HCMEJ) 


Message File 
Manager 
(#CCMQ) 


Console Light 
Manager 
(#CMCI) 


Cleanup 
(Chart 2.13) 
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SYSTEM REQUEST/ENTER AND POWER-ON AID 
SUBFUNCTION 


The system request/enter and power-on aid subfunction 
controls display station mode switching and the 
displaying of the sign-on screen. When the command 
processor changes a display station from command 
mode to console mode, it saves the user screen, swaps 
the TUBs, and restores the console display. The 
command mode TUB is placed on the horizontal TUB 
chain and the console mode TUB is placed on the 
vertical TUB chain. This allows the device controller 
(work station IOCH, remote work station support, or 
distributed host control facility) to process the console 
mode TUB. When the display station is switched back to 
command mode, the TUBs are swapped back and the 
user screen is restored. 


Subtask Initialization 
(#CPSI) 


System Request 
and Power-On 
Processor 


(#CPT3) 


Chart 2.12 System Request/Enter and Power-On Aid Control Flow 
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The following system request/enter and power-on aid 
processes are shown in Chart 2.12: 


1 Display sign-on screen. 


2 Save/Restore command mode screen and stop 
outstanding invites. 


3 Rebuild console screen. 


4 Issue error message if system request not allowed 
at display. 


5 |f swapping from command mode to console mode, 
display outstanding messages for the console. 


Command Processor 
|/O Processor 
(Chart 2.10) 


Sign-On Display 
(#CPTS) 


Command Processor 
|/O Processor 
(Chart 2.10) 


Console Command 
(#CCCO) 


High-Level Help 
Aid Processor 
(#WDHH) 


Console Display 
(4CMCD) 
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COMMAND PROCESSOR CLEANUP SUBFUNCTION 
Command processor cleanup provides miscellaneous 
command-processing-terminating activity and screen 


control for the other command processor transient 
modules. 


The following command processor cleanup processes 
are shown in Chart 2.13: 


1 Route for the following: 

2 Retrieve messages by message identification code 
(MIC), or retrieve messages from main storage and 
display to specified display station. 

3 Log input and/or messages to the history file. 


4 Display message. 


5 If active, refresh status screen and invite input in 
console or subconsole mode. 


6 Display system console and subconsole messages (in 
console or subconsole modes). 


Calling Command Message Retrieve 
Processor Routine 6 


History File Put 


Cleanup Command 
Processor 
(HCMCU) 


Work Station 
Data Management 


Status Mainline 
(#CCSM) 


Console/Subconsole 
Display 
(Chart 2.11) 


$0590047-0 
Chart 2.13 Command Processor Cleanup Control Flow 
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1/O ERROR RECOVERY SUBFUNCTION 4 Perform error recovery for disk, diskette, tape, or 


MICR. 
|/O error recovery issues error messages, recognizes 
operator responses, and handles exception conditions. 5 Handle work station configuration errors at IPL time. 
The error task and command processor subtasks serve 
as the interface between I/O error recovery (main 6 Perform error recovery for MLCA/ELCA. 
storage) and the error recovery procedures in control 
and main storage. The following I/O error recovery 7 Purge error messages and turn off message waiting 
processes, executed under the error task, are shown in light. 
Chart 2.14: 


8 Handle message response. 
1 Route error message. 
The command processor or error task initiates |/O error 
2 Perform printer error recovery. recovery when it is posted with an error event type by a 
control storage routine. 
3 Perform work station error recovery. 
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1,5,8 C & SM Alert 
(4SVWER) 


Task 
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Display Station 


Error Error Router 
Recovery (#SVESP) 
Router 

Transient 


(#SVERP) (#CPML) 


for Console SYSLOG 


MLCA/ELCA 
Controller Recovery 
(#MLCT) 


Command Processor 
Task 
for Work Station 
Device in Error 


Console Management 
(#CMCI) 


Remote Work Station 


Support Task 
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Chart 2.14 I/O Error Recovery Control Flow 
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DISPLAY STATION ERROR RECOVERY 5 Subsequent command reject of command processor 


SUBFUNCTION |/O operation. 
For display station error recovery, the processing is done 6 Subsequent command reject of user program I/O 
under a command processor subtask as shown in Chart operation. 
2.15: 
7 ~~ Ready after command reject of command processor 

1 Route error message. I/O operation (HSVWSR transfers to #SVRD). 
2 Handle message response. 8 Ready after command reject of user program I/O 

operation. 


3 Route for recovery from the following display station 
errors: 9 Retry previously unprocessed error. 


4 First command reject. 


Command Processor 
Subtask Initialization 
(#CPSI) 


History File Put 


or 
Work Station 
Data Management 


Build Error 
Message Routine 
(ASVWER) 


Dual Message 
Routing Routine 
(#CLMSW) 


1,2,3,4 


C & SM Alert Task 


Display Station 
Error Router 
(#SVESP) 


Command Processor 
Task Mainline for 
Console SYSLOG 
(#CPML) 


Command Reject 
Ready Routine 
(#SVRD) 


Display Station 
Error Recovery 
(#SVWSR) 


Display Station 
Error Recovery 
for Device 
Not Ready 
(FSVNRY) 


Work Station 
Data Management 


User Program 
(ready call) 


Command Reject 
Ready Routine 
(#SVRD) 
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Chart 2.15 Display Station Error Recovery Control Flow 


2-60 
This document contains restricted materials of IBM. LY21-0590-4 


©Copyright IBM Corp. 1983, 1984, 1985, 1986 


INITIATOR COMMAND INTERFACE SUBFUNCTION 2 Set up command parameters and route the 


command. 
The initiator command interface allows system programs 
to issue control commands as if the commands were 3 Process command. 
OCL statements. The interface transients, #CPIN and 
#CPOC, build a parameter list, then pass control to the 4 Return the results to the caller. 


input router (HCPRT). The following initiator command 
interface processes are shown in Chart 2.16: 


1 Establish an interface between the initiator and the 


command processor. 


Initiator OCL 
Verb Processor 


Command Processor ‘ = 
mmand Pr r 
Scheduler omma ocesso 


Mainline 
(#CPSC) (HCPML) 


Subtask 
Initialization 
(#CPSI) 


OCL Interface to 
Command Processor, 
Running Under 
User's Task 

(H#CPIN) 


OCL Command 
Interface for 

Command Processor 
(#CPOC) 


Input Router 
(#CPRT) 


Menu Command 
Processor 
(#CCMU) 


Input Job Queue 
Routine 
(#CCJQ) 


Help Control 
Command 
(#CHLP) 


Power Routine 
(4CCPW) 


Message Routine 
(#CCMG) 


Vary Routine 
(#CCVA) 
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Chart 2.16 Initiator Command Interface Control Flow 
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SYSTEM FILE INITIALIZATION FILE SUBFUNCTION 
This subfunction performs the initialization for system 
files required at IPL. The subfunction is started when 
the IPL Command Processor Mainline (HMSSC) receives 
a post indicating that #IPLPROC has completed. 

The following processes are shown in Chart 2.17: 

1 Initialize spool file. 

2 Initialize job queue file. 


3 Initialize message file. 


4 Initialize extended character file. 


Spool File Job Queue File 
Initialization Initialization 
(A4MSSP) (#MSJQ) 


Message File 


Initialization 
(#MSMG) 


Subtask 

Initialization 

(#CPSI) 
EXTN Character 
File Initialization 
(#XDXFD) 
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Chart 2.17 System File Initialization Control Flow 
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Job Start Function 


The job start function contains all SSP programming 
required to start a job, except the command processor. 
It includes the following subfunctions: 


e Initiator Chart 3.1 

e Allocate 
— Normal allocate Chart 3.2.1 
— Special allocate Chart 3.2.2 
— Deallocate Chart 3.2.3 
— Data communications allocate Chart 3.2.4.n 

« Open Chart 3.3.1 


INITIATOR SUBFUNCTION 

The initiator subfunction performs two main functions: 

« OCL statement processing 

¢« Program initialization 

The OCL processor portion of the initiator reads, 
diagnoses, and interprets operational control language 
(OCL) statements supported by the system. The 
program initialization portion performs the steps required 
to load and pass control to the program specified on the 


LOAD OCL statement. 


The initiator can be loaded by any of four programming 
functions: 


e Command processor, when starting a new job 

e Job step termination, when starting a new job step 

e Release, when returning to a procedure from a 
multiple requester terminal (MRT) program or a 


released program 


e Initiator procedure start setup, when evoking a 
startup procedure 
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The following table shows the locations of key data 
areas involved in the initiator subfunction: 


Dump 
Address 


(in Hex) Contents 


mo Mainline module 


3000 _ Initiator work area 


3800 Overflow initiator work area 
4000 Procedure parameter save area (PPSA) 


4800 SYSIN work area 


Active procedure table 


The following initiator functions are shown in Chart 3.1: 


1. Perform preliminary syntax checking of the 
statement and, if necessary, encode the parameters. 
Place the encoded parameters in the initiator work 
area (IWA), which is in task work space (TWS), for 
later use by the statement processor modules. If 
errors are detected, pass control to the initiator error 
handler; otherwise, route control to the appropriate 
verb processing module for each statement. 


2 Check the statement for valid parameters and build 
or modify the appropriate data area (Data Area 
Modified(M) or Built(B)) for use by the system in 
processing the job. 


3 Read the next statement. If not a RUN statement, 
pass control to verb processing module or initiator 
error handler, as before. 


4 Issue error message based on message 
identification code (MIC) passed by verb processing 
module. 


5 Issue error message based on MIC passed by 
initiator mainline. 
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6 Process RUN statement by performing the following 7 ‘If errors are detected, pass control to the initiator 
program initialization processes: error handler; otherwise, load and pass control to 
the supervisor task attach transient. 
e If the requested program is one of the program 
products requiring source, allocate and open the 8 Load and pass control to the requested program. 
$SOURCE and $WORK work files. Also read 
the source statements and place them in the 
$SOURCE file. 


e Enqueue required disk files, based on 
parameters in file statements, and acquire all 


required work stations. 


Procedure 


Data Area 
Start Module Modified (M) 
Setup OCL Verb Called or Built (B) 


Command 
Processor 


// ABEND JCB(M) 

// ALLOCATE JCB(M) 

// ATTR JCB(M) 

// COMM CSB(B) 

// COMPILE CIB(B) 

// DATE JCB(M) 

// DEALLOC JCB(M) 

// DEBUG JCB(M) 

// EVOKE JCB(B) 

// FILE (disk) F1(M or B) 

and FSB(B) 
F1(B) and FSB(B) 
F1(B) and FSB(B) 


Release 


Step 
Termination 


Source 
Distributed 


// FILE (diskette) 
// FILE (tape) 


Initiator 
Mainline 
(#CIML) 


(continued) 


// FORMS 
// IMAGE 
// \NCLUDE 


// \NCLUDE (MRT) 


// \NFOMSG 
// JOBO 
// LIBRARY 


// LOAD 
// LOCAL 
// LOG 

// MEMBER 
// MENU 
// MSG 

// NOHALT 
// OFF 

// POWER 
// PRINTER 


(continued) 


Chart 3.1 (Part 1 of 2) Initiator Control Flow 
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JCB(M) 
PST(M) 
JCB(M) 
JCB(B) 
JCB(M) 


JCB(M), FSB(B), 


and F1(M or B) 
JCB(M) 
LDA(M) 
JCB(M) 
JCB(M) 


JCB(M) 


TUB(M) and JCB(M) 


PSB(B) 
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(continued) (continued) 

// PROMPT oe (continued) 
// REGION (JCB(M) 

// RESERVE FSB(B) and F1(B) 

// SESSION SSB(B) 

// SYSLIST JCB(M) 

// SWITCH JCB(M) 

// VARY 


Initiator // WAIT 


Mainline 


YECIML) //\WORKSTN WSB(B) 


Source 
Distributed 
Data 
Management 
(SDDM) 
Initiator 
Support 
Processing 


Initiator 
Error 

Handler 
(#CIER) gi 


RUN 
Statement 


Processor 
(H#CIRN) Supervisor Task Requested 


Attach Transient User 
6 | Program 


S0590145-1 
Chart 3.1 (Part 2 of 2) Initiator Control Flow 
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ALLOCATE SUBFUNCTION The following normal allocate processes are shown in 


Chart 3.2.1: 


The allocate subfunction controls the ownership of 
system devices and disk space for user (nonprivileged) 
or SSP (privileged) programs. It consists of four parts: 


e Normal allocate: Allocates disk space and devices 


e Special allocate: Allocates disk files, disk space, and 
printers 


e Deallocate: Deallocates disk files, disk space, and 
devices 


e Privileged communications allocate: Allocates 
communications lines for BSC and SDLC tasks 
Allocate Region Map 


The following table shows the locations of key data 
areas involved in the allocate subfunction: 


Dump 
Address (in 
Hex) Contents 


Mainline module 
Allocate work area 


Format-5 buffer 


Normal Allocate 


Normal allocate controls the ownership of devices and 
disk space for the user program. Normal allocate is the 
only allocate function that can be called by a 
nonprivileged user; user programs call allocate via a 
transfer SVC instruction with XR2 pointing to a chain of 
one or more DTFs. Normal allocate processes as logical 
transients. 


Normal allocate is also called by privileged SSP 
programs to acquire ownership of system devices such 
as the diskette drive, the tape drive(s), and the 1255 
MCR. 
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Do the following mainline functions: 
e Acquire necessary task work space (TWS). 


e Set indicators for other DTF processing 
required. 


e Perform central router and mainline function for 
the processing of each applicable DTF on the 


chain. 


e When processing for all allocation modules is 
completed, delete TWS and return to caller. 


Perform the following disk file processing: 


e« If resource security is active, call security to 
check for user authorization. 


« Allocate old files for input operations. 


e Reset old-files-for-output attributes as 
required. 


e Set attributes for new files according to FILE 
statement parameters and DTF. 


e« If requested file is remote, route control to 
source distributed data management allocate. 


Perform the following for diskette files: 


¢ Verify file format, check for file expiration, and 
check for file date differentiation. 


¢« Display applicable errors to user via SYSLOG. 
Do the following for BSC files: 


e Acquire line and load necessary control storage 
communications programming. 


« Call task attach to attach BSC interrupt handler. 
Do the following for 1255 MCR files: 
e Acquire 1255. 


e Load necessary control storage MCR 
programming. 
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Special Allocate 


Special allocate allows privileged SSP programs to 
perform initiator and allocate functions without 
user-specified OCL. The special allocate subfunction is 
evoked by a transfer SVC instruction with XR2 pointing 
to the special allocate parameter list; it processes only 
one request per call. 


The privileged user has the option of processing errors, 
or allowing allocate to process them. If allocate does 
not process the errors, they are passed to the caller as 
MICs in the parameter list return code field. Special 
allocate processes as a logical transient. 


The following special allocate processes are shown in 
Chart 3.2.2: 


1. Do the following initiator and first-stage allocate 
functions: 


¢« Acquire necessary task work space (TWS). 
« Get request from parameter list. 


e Ensure special allocate request is for printer file 
or disk file only. 


e Perform central router and mainline functions 
for other required special allocate modules. 


e If requested file is remote, route control to 
source distributed data management allocate. 


e When all special allocate modules complete 
processing, delete TWS and return to caller. 


2 Check for file existence when required. 


3 Process multiple index files. Call VTOC access to 
get multiple index family from the VTOC. 


4 Perform the following disk file processing: 


e If resource security is active, call security to 
check for user authorization. 


e Allocate old files for input operations. 


e Reset old-files-for-output attributes as 
required. 
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e Set attributes for new files according to 
parameter list and DTF. 


e If requested file is remote, route control to 
source distributed data management allocate. 


5 Do the following for new disk file allocation: 


« Calculate the required blocks. 


e If request is for an S or J file and reserve area 
is available, get space from reserve area; 
otherwise, use system format-5 free space 
table to claim space. 


6 Perform the following disk file processing for each 


Output disk file being allocated: 

e Calculate file capacity in number of records. 

e Format files for file recovery on resident disk 
files Update or add a VTOC entry for each 


resident disk file. 


e Establish disk sector addresses (index and data 
areas for indexed files). 


7 Do the following for printer DTFs: 


e Find or build the PSB and IOB. If possible, 
acquire the requested printer. 


e If spooling is active for the printer, set up print 
file for print spooling. 


e If request is for remote printer that is not 
available, call RWS vary on to check for printer 
condition. 


e If printer file is direct and if printer type 
verification is requested, verify IGC printer type 
(IGC, 1GC18, or IGC24). 


e — If printer file is direct, call image verify to 
confirm image, forms number, CPI, LPI, 
Ideographic CPI (IGCPI), and Ideographic shift 
in, shift out (SOSI). 


8 Prepare data to be issued to SYSLOG (or for the 


return code to be set in the parameter list) for errors 
detected in any of the allocate modules. 


Note: Although control flow is not shown, all allocate 
modules can call #CAMG directly. 


This document contains restricted materials of IBM. LY21-0590-4 
©Copyright IBM Corp. 1983, 1984, 1985, 1986 


Privileged User 


Program via Transfer 
SVC Instruction 


Disk VTOC 


Access 


Special Allocate 
Multiple Index 
File Processing 
(#CAMI) Resource Security 


Check 1 


New and Old 
Disk File 
Allocate 
(#CAM2) 


Source Distributed 
Data Management 
(SDDM) Processing 


Special 


Allocate 5 
unre New File Es 
Space Acquire 
New/Load-to-Old 
; (#CAF1) 
6 File Capacity 
Calculation Remote Work 
(#CAF3) Station Vary-On 
Processor 
7 Printer 9 | 
Allocate 
(#CAPT) Image 
Verify 
Allocate (#CSSM) 
: message SYSLOG 
Processor Gi 


(#CAMG) 


$0590147-1 


Chart 3.2.2 Special Allocate Control Flow 
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Deallocate 


Deallocate allows a privileged SSP program to perform 
termination functions on disk files, printer files, and the 
tape or diskette drive without going through end-of-job 
processing. Privileged SSP programs call deallocate via 
a transfer SVC instruction with XR2 pointing to a special 
disk allocate parameter list, a special printer allocate 
parameter list, or a diskette, tape, MCR, or printer DTF. 
Deallocate processes only one request per call and 
processes as logical transients. 


Privileged SSP programs have the option of processing 
errors, or allowing deallocate to process them. If 
deallocate does not process the errors, they are passed 
to the caller as MICs in the parameter list return code 
field. 
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The following deallocate processes are shown in Chart 
3.2.3: 


1 Do the following: 
« Acquire necessary task work space (TWS). 
e Initialize for deallocate. 
e Check for valid deallocate call. 
e Route for required processing. 


e After all deallocate processing is complete, 
return to caller. 


2 __|f resource security is active, ensure proper user 
authorization for deleting or changing a disk file. 


3 If request is for remote file, perform distributed data 
management file deallocate. 


4 sIf required, check for duplicate keys and perform file 
sort. 


5 Test for file existence and perform latest date 
checking. 


6 If multiple index file, deallocate it. 


7 Perform deallocate function on printer files, diskette 
drive, 1255 MCR, and tape drive. 


8 Free file space. 
9 Prepare data to be issued to SYSLOG (or for the 
return code to be set in the parameter list) for errors 


detected in any of the allocate modules. 


Note: Although control flow is not shown, all deallocate 
modules can call #CAMG directly. 
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Source Distributed 
Data Management 
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Deallocate 6 Deallocate Multiple 
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Chart 3.2.3 Deallocate Control Flow 
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Data Communications Allocate The following user program data communications 


allocate processes are shown in Chart 3.2.4.1: 
Data communications allocate processes line allocate 


requests by doing the following, as required: 1 For each communications DTF in the chain, perform, 


or route for, the following: 
e Acquire communications line 


e Find or build a CSB for the line and acquire 


e Load control storage microcode (resource enqueue) the line. 

¢ Build communications specification block (CSB) e Load the appropriate communications 
microcode if not already loaded, and update the 

e Build error recovery block (MLCA/ELCA only) device allocate table. 

Data communications allocate is invoked by both ¢ If MLCA/ELCA, find or create an ERB. 

privileged SSP programs and by user programs. When a 

privileged SSP program invokes allocate, XR2 points to e Mark DTF and CSB as allocated. 

the parameter list; when a user program invokes 

allocate, XR2 points to a chain of DTFs containing at 2 Attach data communications task. 


least one data communications DTF. 
3 Issue required messages. 


BSC Allocate System Task 
(#CABC) Attach 
aa sell Allocate Mainline 
via Transfer | (CAML) 
SVC Instruction 
Allocate Message 
Processor SYSLOG 
(#CAMG) gi 
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Chart 3.2.4.1 Data Communications Allocate Control Flow 
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The following privileged SSP program data 3 


communications allocate /deallocate processes are 
shown in Chart 3.2.4.2: 


1 If SDLC parameter list, perform or route for the 
following: 


« Find or build a CSB for the line and acquire 
(resource enqueue) the line. 


« Load the appropriate data communications 
microcode (if not already loaded) and update 
the device allocate table. 


e If MLCA/ELCA, find or create an ERB. 


e Update the CSB and parameter list to show 
allocate status. 


2 If BSC or asynchronous parameter list, perform or 
route for the following: 


« Find or build a CSB for the line and acquire 
(resource enqueue) the line. 


e Load the appropriate communications 
microcode (if not already loaded) and update 
the device allocate table. 


¢ If MLCA/ELCA, find or create an ERB. 


« Attach the appropriate data communications 
data management task. 


e Update the CSB and parameter list to show 
allocate status. 


SDLC Line 
Allocate /Deallocate 
(ACARW) 


Privileged SSP 


Program via BSC/Asynchronous 


Line 
Allocate /Deallocate 
(#CABC) 


Transfer SVC 
Instruction 


Chart 3.2.4.2 Data Communications Special Allocate Control Flow 
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Perform or route for deallocate requests: 


e If there are no other line users, dequeue and 
free CSB and release (resource dequeue) the 
communications line. 


e« If there are no other users of the control 
storage microcode, unload the microcode and 
update the device allocate table. 


e If MLCA/ELCA, and this is the last user of the 
ERB, dequeue and free ERB. 


« Update parameter list to show successful 
completion. 


¢« Return any error messages required in the 
caller's parameter list. 


System Task 
Attach 


Allocate Message SYSLOG 
Processor 


(#CAMG) 6 | 
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OPEN SUBFUNCTION 


The 


open subfunction prepares for the transfer of data 


to and from files and devices allocated to a program by: 


Initializing all necessary file DTF fields 


Assigning buffers, control blocks, and any required 
lIOBs 


Preparing for |/O operations to/from data files and 
devices 


Common open is contained within the first disk open 
transient and the printer open transient. Open consists 
of two common open transients and the following 
device-oriented open transients: 


The 


Disk open 

Work station open 
Diskette open 
Printer open 

BSC open 

Tape open 


calling program invokes open with a transfer SVC 


instruction and XR2 pointing to the first DTF on the DTF 
chain. The control storage SVC processor loads the first 
common open transient (#DD10P). 


The 


1 
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following open processes are shown in Chart 3.3.1: 
Perform the following: 


« Check all DTFs on the forward chain for valid 
device codes. 


« Check that all DTFs to be opened have been 
allocated. 


e« If errors found, issue messages through 
SYSLOG. 


e If no disk DTFs are on the chain, call other 
device opens. 


e Perform diagnostic checking for all disk DTFs 
and issue any required messages through 
SYSLOG. 


e If a privileged program requests it, perform disk 
pseudo open by moving the following 
information from format 1 to the DTF: 

— Record length 
— Block length 
— File type 


e Complete processing for any sectorized data 
management access method (ZPAM) DTFs and 
route control to #DD2OP for other disk DTF 
processing. 


Perform the following on disk (other than ZPAM) 
DTFs: 


e Verify format 1, then copy format-1 data to 
DTF and FAB. 


e Calculate file space needed for physical buffers 
and disk data management required control 
blocks. 

e Determine if location for file space is within 
program (privileged programs only), appended 
to program, or in TWS. 


e Map to file space. 


« Format file space and set up SQS data areas 
for disk data management. 


e« Call keysort or quicksort if required. 


« If DTF is for a remote file, call distributed data 
management open. 


e If indexed file or multiple index file (and file is 
not remote), call #DD3OP. 
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3 Process disk DTF open requests from a remote 8 Process any BSC DTFs on the forward chain, then 
system for local files or from a local user for remote return control to printer data management open. 
files. 


9 Execute job with opened DTFs. 
4 Perform the following indexed-file-DTF open 


functions: 10 Open all tape DTFs: 
« Set up high key data areas required for indexed ¢ Build tape IOB. 
files. 


¢ Set up physical buffer. 
e Set up storage index for primary portion of file 
index. e Load appropriate tape data management 
module. 
5 Open any diskette DTFs on the forward chain. 
11 Issue any required error messages. 

6 Perform the following work station DTF open 

functions: 


¢« Validate device type and build format index area 
(offsets from load member disk address) for 
format load members for the following: 
— Keyboard DTFs. 
— Console DTFs. 
— CRT DTFEs. 
— Work station DTFs. 


e Pass control to printer data management open. 
7 Place all DTFs that are on the forward chain on the 

JCB backward chain, then process any printer DTFs 

on the forward chain: 

« Check for valid entries in the user DTF. 


e Initialize fields in the user DTF. 


e Check that an |IOB was assigned by allocate; 
initialize the IOB fields. 


e Send initial SCS (printer prepare character 
string) commands to the printer. 
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Calling Program 
via Transfer 
SVC Instruction 


Diskette File 
Open 
(#DROP) 


Tape Open 
(#TAOPN) 


Disk Open 
Phase 1 
(#DD10P) 


Work Station 


Open 
Phase 2 
(#DD20P) 


SYSLOG 
Disk Open 
Phase 3 6 | 


(#DD30P) 


Printer Data 
Management Open 
(#DPOP) 


BSC File 
Open 


(#BSOB) 


Quicksort 


Source Distributed 
Data Management 
(SDDM) Processing 


(#DDD5) 


Keysort 
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Chart 3.3.1 Open Control Flow 
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Job Execution Function 


The job execution function consists of common data 
handling subfunctions that are used by application 
programs and/or privileged SSP programs. It includes 
the following subfunctions: 


Data management processing Chart 4.0 
Disk data management Chart 4.1.1 
processing 

Diskette data management Chart 4.2.1 
Printer data management Chart 4.3.1 
Work station data Chart 4.4.0 
management 

Print spooling Chart 4.5.0 
Sector data management Chart 4.6 

to disk 

Keysort Chart 4.7 
Tape data management Chart 4.8 
1255 MCR data management Chart 4.9 
OFFICE/36 support Chart 4.10.0 
Distributed data Chart 4.11.0 
management (DDM) 

Query data management (QDM) ~— Chart 4.12.1 
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DATA MANAGEMENT PROCESSING 
SUBFUNCTIONS 


SSP data management subfunctions provide an 
SVC/DTF interface to calling programs, and common 
error detection/recovery for user files. The disk, printer, 
and work station data management subfunctions are 
invoked via the fast transfer SVC instruction; front-end 
code in each of these subfunctions determines if the 
request can be responded to immediately or if it must 
be delayed due to processing requirement. 


The data management for each device ensures that the 
DTF is open and then checks the DTF device code to 
determine the type of data management requested. 
Chart 4.0 shows the overview control flow for the data 
management subfunctions. 


The following preliminary data management processes 
are shown in Chart 4.0: 


1 Check fast transfer request to determine if 1/O or 
other time-consuming operation is required to 
process request. 

2 If requested data is in a buffer, if the requested 
operation requires minimal time, or if DTF is not 


open, fast exit to caller with completion code. 


3. If detail processing is required, fast exit to process 
request and return to caller with completion code. 


4 Process data management service requested in 
user's DIF. 


5 Perform detail data management service requested. 


6 Perform detail OFFICE/36 support service 
requested. 


7 Perform detail distributed data management service 
requested. 


8 Perform detail query processing requested. 


Note: The return to user is not necessarily from the 
detail operation processor. In some cases, the 


applicable data management router receives control back 


and then passes control and the completion code back 
to the caller. 
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Calling Program 
via Fast 
Transfer SVC 
Instruction 


Calling Program via 
Branch Instruction 


Calling Program via 
SUBRO8 or SUBR25 


OFFICE/36 via 
SVC Instruction 


Calling Program via 
SVC Instruction 


Disk Data 
Management 
(Chart 4.1.1) 


Printer Data 
Management 
(Chart 4.3.1 or 4.3.2) 


Work Station 
Data Management 


(Chart 4.4.1) 


Diskette Data 


Management 
(Chart 4.2.1) 


1255 MCR Data 
Management 
(Chart 4.9) 


OFFICE/36 
Support 
(Chart 4.10.0) 


Query Data 
Management 
(Chart 4.12.1) 


Detail Disk 
Data Management 
Processing 


Detail Printer 
Data Management 
Processing 


Detail Work Station 
Data Management 
Processing 


Tape Data 
Management 
(Chart 4.8) 


Distributed Data 
Management (DDM) 


(Chart 4.11.0) 
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Chart 4.0 Data Management Overview Control Flow 
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Disk Data Management 


Disk data management performs all main storage disk 
file processing. It consists of a resident portion that is 
loaded by main storage IPL and a set of system 
transients. 


Disk data management provides support for the 
processing of the four System/36 disk file types: 
e Sequential: Records are in the order that they 
were originally entered. 

e Indexed: Records are in any order, with 
access by an index that contains a 
key or physical location entry for 
each record. 

« Direct: Records are ordered by a 
programming algorithm (usually 


based on a field value in the record). 


e Multiple 
Indexed: 


Records are in any order, with 
access by a conventional 
indexed-file index that contains a 
key or physical location entry for 
each record. 


Disk data management provides support for the 
processing of the following user requests: 


e Get 

e Update 
e Delete 

e Add 

e Release 
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Disk Data Management Region Map 


The disk data management mainline module (7_DDDM) 
resides in the fixed nucleus. Disk data management 
data areas can reside in one of two places, dependent 
on the size of the application program region. 


lf the user program region is large enough, DTFs and 
logical buffers reside where they were compiled in the 
user’s program. The physical buffers are appended to 
the end of the user’s program. 


If the application program region is too small, the disk 
data management data areas reside in TWS at the 
locations shown in the following table: 


Address 
(in Hex) Contents 


2000 


Logical buffer 


4800 Physical buffers 


Generally, callers prepare for a call to disk data 
management by doing the following: 


e Set up DTF (done by allocate, using FILE 
statement). 


e Set up file access block (FAB), file buffer block 
(FBB), and disk buffer block (DBB) (done by open). 


e For a put, place data in logical buffer; for a get, set 
up applicable record pointer in DTF. 


e Set op code and file attributes in DTF and point 
XR2 at DTF. 


e Issue fast transfer SVC instruction. 
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The 


following disk data management processes are 


shown in Chart 4.1.1: 
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Examine request and determine if it can be 
processed immediately or if it must be delayed. 


e« If request can be processed immediately, move 
data to or from caller; then return to caller via 
fast exit SVC instruction. 


e If request requires delayed processing, go to 
mainline processing via fast exit SVC 
instruction. 

e« If request is for a remote file, route control to 
distributed data management get/put 
processing. 

Process get/put request for remote file. 

Do the following mainline processing: 

« Verify that file is open and that access method 
is not sectorized data management access 
method (ZPAM). 


e If necessary, map to file |/O area. 


¢« Route to appropriate operation handler, based 
on request. 


«  \f request was terminated because record was 
locked, retry. 


e Return completion code to caller, based on 
completion code received from operation 


handler. 


Do disk |/O operations: 


e Get 

e Update 
e Delete 
e Add 


Process fix-end-of-data request: 


e« Verify that file is allocated exclusively, that file 
is sequential, that no indexes are defined, and 
that processing includes a delete. 


« Reset last record address (in FAB) to current 
cursor plus 1, and reformat remainder of file to 
zeros. 


Process set beginning-of-file (BOF) /end-of-file 
(EOF) request by resetting cursor state position (in 


FAB) to BOF or EOF. 


Process exception condition: 


Initialization of variables for selection 
expression. 


e Abnormal termination. 

¢ Implicit update/delete read. 

e File extension initialization. 

e Keysort. 

If operator selected SYSLOG option 2 in response 
to an error, return to caller; otherwise, return 


condition to #DDDM. 


Process index entry insert request for each index to 
be updated: 


e Ensure that buffer is large enough for 
in-storage insert or sort. 


e If buffer is not large enough, determine exact 
point of insert, and determine whether an 
in-storage insert or sort is possible. 


e If the buffer is not large enough, scan the index 
for a gap. If a gap is found, determine whether 
an in-storage insert or sort is possible. 


e« If an in-storage insert is possible, perform it; 
otherwise, shift overflow by 1 sector, starting at 


insert point and insert new entry. 


e Update the index control block (XCB) queue. 
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9 Perform record selection based on selection 10 Process release request; unlock record by turning 
expression passed by caller (SCOPY or other utility): off lock bit in record queue block (ROB). 


e Check record against token in string with 
nested do-until loops; continue do-until loops 
until true, error, or end-of-file condition is 
detected. 


e Return condition to #DDDM. 


User Program via 
Fast Transfer SVC 
Instruction with 

XR2 amp DTF 


4 Charts 4.1.2 
through 4.1.5 


Distributed 


Disk Data Data Disk Data Management 
Management Management Exception Processing 
Mainline (Chart (#DDD4) 

(#DDDM) 4.11.0) 


Steppe eee ee oe Po o Fix-End-of-Data 
Deblocking Routine 


Routine 


meee ie oe 


Set Cursor to 
BOF/EOF State 
Routine 


| I 
Abnormal Termination 
Routine 


Mainline 


Routine 8 | Disk Data Management 


Insert Index 
(#7DDD2) 


Implicit Update / 
Delete Routine 


File Extend Initialization 


Disk Data Management 
Routine 


Selection Expression 
Evaluation 9 
(#DDD3) 


Selection Expression 
Initialization Routine 


Keysort 
(Chart 4.7) 


(emcee ee i ie = 
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Disk Data Management Get Request Processing 


Disk data management get request processing proceeds 
in the following general sequence: 


The 


If get by key, move key (pointed to by DTF) into 
index buffer. 


Insert scan op code and SSSQ@ into IOB. 


Move index buffer address from file buffer block 
(FBB) into IOB and point XR1 at IOB. 


Call control storage disk IOS to scan sectors and 
return the sector containing the requested key; 
move the RRN to the work area. 

If non-indexed-random get, move RRN from DTF 
to work area; if unkeyed sequential get, move RRN 


from FAB to work area. 


Convert work area RRN to SSS@ and insert read 
op code and SSS@ into IOB. 


Call control storage disk IOS to perform get. 


following disk data management get-request 


processes are shown in Chart 4.1.2: 


1 
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Do the following: 

¢ Check for request validity. 

e Route for keyed or unkeyed get. 

« Update cursor in FAB. 

e Dequeue the file via format 1. 

« Return DTF with completion code. 

Perform unkeyed get: 

e If shared file, enqueue file via format 1. 

e Determine RRN of requested record. 

e Route to get record routine. 

e« |f requested record has been deleted or if 
record does not match a selection expression, 


read next record or terminate, based on request 
type. 


Perform get: 


e If operation and file sharing level require it, 
enqueue record. 


e If record is locked, return to mainline for retry. 


e If record is already in disk data management 
data area, move it to user’s record buffer; 
otherwise, call control storage disk IOS to read 
sector(s) containing record from disk to disk 
data management data area. 


¢« Copy record from disk data management data 
area to user’s record buffer. 


Perform keyed get: 
e If shared file, enqueue data space via format 1. 


« If next record is specified, determine prime and 
overflow entries relative to current key. The 
lesser of the two becomes the new current key. 
If no entry is found, terminate. 


« If previous record is specified, determine prime 
and overflow entries relative to current key. The 
greater of the two becomes the new current 
key. If no is entry found, terminate. 


e If first is specified, start at beginning of index; 
if last is specified, start at end of index. 


¢ If get by key equal, high/equal, or high is 
specified, scan index for lowest key 
higher /equal to requested key. If no entry 
found, terminate. 


« Determine RRN of requested record. 

e Route to get record routine. 

e« If requested record has been deleted or if 
record does not match a selection expression, 
read next/previous record or terminate, based 


on request type. 


e« If limits were set and the record does not 
satisfy them, abnormally terminate the request. 
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Disk Data Management 
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Routine 


Get Router 
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Chart 4.1.2 Disk Data Management Get Control Flow 
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Disk Data Management Update Request Processing - If index requires unique keys, check for 
duplicates. 

A get on the requested record must be performed 

before the update can be done. The requested record is «© Move/write record. 

contained in the user's buffer. 

e For each alternative index that required 

The following disk data management update-request updating, read the entry corresponding to the 

processes are shown in Chart 4.1.3: updated record. Delete the old entry and add a 
new entry to each index. 

1 Do the following: 


e Dequeue data space via format 1. 
e Check FAB to ensure update is allowed. 


e Return DTF with completion code. 
¢ If file is delete-capable, check that first byte of 


record is not hex FF. 2  Move/write record: 
« If shared file, enqueue data space via format 1. ¢ Move record from user buffer to physical 
buffer. 


e Compare old key to new key. 


e Call control storage disk IOS to write modified 
e If key modification has been performed, ensure record to disk. 


that index allows it. 


Disk Data Management 
Router (#4DCDM) 
Routine 


-— ew ew ww ee ee oe oe _— we ee oe ee es = —_— em ew a a a oie a ee om ew o a am am a= =a 


Update Record 2! Move/Write Control Storage 
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Disk Data Management Delete Request Processing 
A get operation on the requested record must be 
performed before the delete can be done. The 


requested record is contained in the user's buffer. 


The following disk data management delete-request 
processes are shown in Chart 4.1.4: 


1 Do the following: 


e Check FAB to ensure that delete is allowed and 
that file is delete-capable. 


e If shared file, enqueue data space via format 1. 


e Mark record in physical buffer as deleted by 
filling record bytes with hex FF. 


e If keyed, place hex 00 in key and hex FF in 
RRN. 


e Call control storage disk IOS to write record to 
disk. 


e For each alternative index defined over the file, 
read the entry corresponding to the deleted 
record. Mark the entry as deleted and call 
control storage disk IOS to write it back to disk. 


e Dequeue data space via format 1. 


e Return DTF with completion code. 


Disk Data Management 
Router (#DDDM) 
Routine 


Delete Record 
Routine 


Control Storage 


Gem es wwii i 


we ee i oi ie em am oe @ @ == 
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Disk 


Data Management Add Request Processing 


Disk data management add request processing proceeds 
in the following general sequence: 


The 


Move logical buffer to physical buffer. 

Determine if buffer must be written to disk by 
checking if buffer full condition or file sharing is 
applicable. 

If buffer must be written to disk, move physical 
buffer address from file buffer block (FBB) into I|OB 
and point XR1 at IOB. 


Call control storage disk IOS to write buffer to disk. 


On return, get new key from user and add to or 
alter index buffer. 


following disk data management add request 


processes are shown in Chart 4.1.5: 


1 
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Do the following: 


e If file is delete-capable, ensure that first byte of 
record is not hex FF. 


e If shared file, enqueue file via format 1. 


e Route to subroutine to check indexes for invalid 
duplicate keys. 


« If add (RRN) is specified: 

— Verify (using FAB) that the operation 
includes add (RRN). 

— Verify that file is delete-capable or new 
direct file. 

— Read the specified record into the physical 
buffer. 

— If the file is delete-capable and record slot 
does contain a record, abnormally 
terminate; otherwise, move record from 
user's buffer to physical buffer, and call 
control storage disk IOS to write it to disk. 


e If add (EOD) is specified: 
— Verify (using FAB) that the operation 
includes add (EOD). 
— Verify that file is not a direct file. 
— Add record to end of file. 


« If the last operation was an add (EOD) and 
Output is deferred, move record from user's 
buffer to physical buffer without reading disk. 


« If the last operation was not an add (EOD) or 
output is not deferred, read disk and move 
record space into physical buffer. 


¢ For each index defined over the data space, add 
a new entry for the added record. Depending 
on sharing level, file attributes, and processing 
requested: 
— Mark format 1 to indicate file sort required. 
— Add key to end of overflow area or insert 
it, to preserve sequence. 


« Dequeue data space via format 1. 
« Return DTF with completion code. 
Check each index defined over the data space. If 
duplicate keys are not allowed, ensure that added 
key is unique. If duplicate key found, abnormally 


terminate. 


Insert key in index overflow area. 
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Chart 4.1.5 Disk Data Management Add Control Flow 
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DISKETTE DATA MANAGEMENT The following diskette data management processes are 


shown in Chart 4.2.1: 
Diskette data management is loaded by diskette open. 


It processes three file types: 1 Perform diskette data management services: 

e Basic data exchange files e Initialize for user request. 

e l-exchange files ¢ Check for end of data. 

« System files ¢ For move mode, block or deblock records 


between work buffer and |/O buffer. 
Basic data exchange files are created by the System/36 


$BICR utility, the System/36 $MAINT utility with ° 
BASIC-YES specified, or are copied by the System/36 

$DUPRD utility. |-exchange files are created by the 

System/36 $BICR utility, or copied by the System/36 

$DUPRD utility. System files are created by the 

System/36 $COPY or $MAINT utility or copied by the : 
System/36 $DUPRD utility. 


For locate mode, point DTF to location in |/O 
buffer containing requested input data or to 
location in |/O buffer where output data is to 
be placed. 


Read or write |/O buffer. 


e Issue SVCs for diskette IOS. 
Diskette data management can process in either record 


mode or sector mode. The following record mode data e Restore pointers and data areas. 
management access types support the file types listed 
above: e If end-of-volume processing is required, start 


it; otherwise, set DTF completion code and 


e Put basic record (PBR) 

¢ Get basic record (GBR) 

e Add basic record (ABR) 
e Put l-record (PIR) 

e Get I-record (GIR) 

e Add |-record (AIR) 

« Put system record (PSR) 
« Get system record (GSR) 


« Add system record (ASR) 


return to user. 
2 Process end of volume: 


« If required, rewrite data set label. 


¢« If required, set continuation indicator. 


¢ If required, issue message (via SYSLOG Ei) to 


operator. 


3 If required, read/write diskette VTOC. 


Sector mode data management provides users with the 
capability of moving considerable amounts of data to or 
from diskette. It uses a single input/output buffer that is 


filled by a single read operation, or is written to disk 


with a single write operation. Data management is 
loaded by diskette open. 
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Chart 4.2.1 Diskette Data Management Control Flow 
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PRINTER DATA MANAGEMENT The active work block (address contained in a queue 
header) contains pointers to the printer DTF, the printer 


Printer data management prepares and moves all print IOB, the logical buffer and the physical buffer. 
requests from user programs, and most print requests 

from system programs. (Some system programs use The following printer data management processes for a 
SYSLIST [.) If spooling is active, printer data nonspooled request are shown in Chart 4.3.1: 
management prepares all print requests and routes the 

data to the spool file. Calling programs put the data into 1 Do the following: 

a logical buffer, insert skip and space values into the 

DTF, point XR2 at the DTF, then call the printer data e Set normal completion code in DTF. 
management spool intercept router via the fast transfer 

SVC instruction. ¢ Move skip/space information from DTF to IOB. 
The printer data management spool intercept router e Set up physical buffer in SOS: 

(#SPRT) is a nucleus resident program; all other printer — Move logical buffer to physical buffer. 
data management modules are translated transients. — Move data string length to IOB. 


— Set print indication in |OB control byte. 
Printer data management processes for nonspooled 


requests are shown in Chart 4.3.1; printer data 2 Unless a transparent-mode record or a get printer 
management processes for spooled requests are shown status request, prepare print buffer and check for 
in Chart 4.3.2. EXTN characters. 


3 Point XR1 at the IOB and call printer data 


Printer Data Management Region Map management via the fast exit SVC instruction. 


The following table shows the locations of key data 4 
areas involved in the printer data management 
subfunction: 


Check for the following: 
e Data includes EXTN characters. 


Dump e Print request is for local printer. 


Address 
(in Hex) Contents 


ee 5 If EXTN characters are in print request, convert 
them to RAM addresses. 
(1000 SCS Printer data management (#DPDM) 
1800 Spool intercept (#SPINT) 6 If intelligent printer data stream (IPDS) printer, call 


intelligent printer facility (IPF). 


e« Print request is for remote printer. 


Printer DTF (mapped to when printer 

data management processes 7 
transparent-mode records and 

nonspooled requests) 3 


If local print request, execute it. 


If remote work station request, route request to 
Logical buffer (mapped to when printer remote printer. 

data management processes transparent 

mode records) 9 Return DTF with completion code. 


4000 Spool intercept buffer 
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Chart 4.3.1 Nonspool Printer Data Management Control Flow 
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The following printer data management processes for a 3 Move physical buffer to spool intercept buffer. 
spooled request, other than transparent-mode records 


and get printer status requests, are shown in Chart Note: If possible, the spool intercept buffer is 
4.3.2: appended to the user program; if not, it is built in 
SQs. 


1 Do the following: 


If intercept buffer is full, call printer data 
management via the fast exit SVC instruction; 
otherwise, return to caller via the fast exit SVC 
instruction. 


e Set normal completion code in DTF. 
¢« Move skip/space information from DTF to IOB. 


* Move logical buffer to physical buffer. 4 Pass control to spool intercept to write buffer to 


disk. 
2 Prepare print buffer and check for EXTN characters. 


5 Perform required disk operations. 


6 Return DTF with completion code. 


Control Storage 


Printer Data 
Management Spool 
Intercept Router 
(#SPRT) 


Disk |OS 


Calling Program 
via Fast Transfer 
SVC Instruction 


Printer Data 
Management 
(4DPDM) 


Spool Intercept 
(Chart 4.5.2) 


$0590124-0 
Chart 4.3.2 Spool Printer Data Management Control Flow 
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INTELLIGENT PRINTER FACILITY The following IPF processes are shown in Chart 4.3.3: 


The intelligent printer facility (IPF) is a data stream 1 Copy the input data to the input buffer. 
transformation routine and resource management 
routine for printers that support the intelligent printer 2 Translate input data to IPDS and place it in the 
data stream (IPDS). outside buffer. 
IPF accepts SNA character string (SCS) commands, 3 If requested, retrieve graphics data from the 
document control architecture-level 2 (DCA-L2) graphics object file. 
commands, or IPDS commands as input. The output 
from IPF is always on IPDS data stream. 4 siIf this is the end of a page, send the print data: 
Functions that normally interface with printers such as e — If the printer is locally attached, print data on 
printer data management, syslist, and the spool writer the appropriate local printer. 
will call IPF if the printer is an IPDS device. IPF will 
perform the data stream transformation and interface e If the printer is remotely attached, send the 
with the printer. The input to IPF is a printer IOB pointed print data to the appropriate remote printer. 
to by XR1. 

5 Return. 


IPF Region Map: 


0800 Nucleus 

1000 IPF (#DPIP) 

3800 Input buffers and work areas 
3C00 Output buffer 


Control Storage 


Calling Program IPF 
(#DPIP) 


Work Station / 
Printer 


Remote Work Station 
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WORK STATION DATA MANAGEMENT 


Work station data management (WSDM) runs as a 
subroutine under the user task and controls all |/O 
requests to display stations, including the routing of 
requests for SSP-ICF. User program requests to 
WSDM are passed via the fast transfer SVC instruction 
with XR2 pointing to the user’s DTF; system (privileged) 
program requests are passed with XR2 pointing to a 
48-byte work station parameter list (WSPL) in real 
storage. The WSDM router first checks to ensure that 
the user’s DTF is opened; if it is not opened, WSDM 
fast exits back to the user with a completion code 
indicating the DTF is not opened. If the DTF is opened, 
the WSDM router fast exits to the appropriate module 
to handle the request. 


WSDM converts any DTF request received to a work 
station parameter list (WSPL), assigns space in SQS, 
places the WSPL in the assigned SQS, then points XR2 
at the WSPL. 


For formatted output requests, WWSDM merges the 
user’s data with the SFGR-created screen format and 
writes the data to the display screen. For input 
requests, WSDM takes data entered at the display 
station and places it in the user's buffer. The WSDM 
router, #DWDM, resides in the main storage nucleus 
and calls translated routines to perform most detail 
operations. 


Many work station data management processes are 
dependent on the work station being in certain states at 
the time the processes are performed. The following 
definitions explain these states. 


ACQUIRE/ATTACH/OWN: Each work station is always 
attached to, or owned by, a system or user 
task. This attachment is indicated by a field 
in the work station’s TUB. All work stations 
are owned by the command processor until 
they are acquired by a user task or a system 
task. 

INVITE: If the system is to receive input from the 

display station keyboard, it must issue an 

invite to the display station. When a display 
station is invited, the keyboard is unlocked 
and the invite bit in the display station TUB 
is set on. Control storage work station 

IOCH posts work station data management 

when input is received from the keyboard. 


The invite can be combined with a put 
operation. During a put with invite 
operation, the system puts up a display 
then allows for an operator response; 
during a stop invite then put operation, the 
TUB invite bit is set off (to prevent control 
storage work station IOCH from posting 
WSDM) then a put is performed. 


1 


RELEASE: When a system or user task no longer 
needs an attached work station, the task 
releases the work station to the command 
processor. On release, the ownership of the 
work station, as indicated by a field in the 


work station’s TUB, is changed. 
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Work Station Data Management Region Map 3 Perform diagnostic checks on get requests and 
route for required processing. 

The following table shows the locations of key data 

areas involved in the work station data management 4 If a severe error is detected, terminate. 

subfunction: 

5 If a work station error is detected, process error 


Dump (command rejects or permanent errors) and set up 


Address return code. 
(in Hex) Contents 


6 Return work station parameter list to DTF; if input 
Mainline module. operation, return data, then return to caller. 
Format index entries. 7 


or 
Mapped WSQS which includes format 


If DTF was not opened, DTF completion code is 
only data changed; return DTF completion code to 
caller. 


object S, H, and D specifications and the 
data stream. 


User's record area address. 


When display formats have been 
configured to reside in main storage, 
WSDM will map the format object in 
SWS at X'COOO and copy the format 
object to WSQS. 


The following work station data management overview 
processes are shown in Chart 4.4.0: 


1 Determine if input is for a work station or SSP-ICF: 


e If first character of SYMID is numeric, route 
SSP-ICF request to SSP-ICF data management. 


¢ If first character of SYMID is alphabetic, route 
request to work station data management put 
or get mainline. 


¢ Build work station parameter list (WSPL) from 
information in DTF. 


2 Perform diagnostic checks on put requests, perform 
initial request processing, and route for additional 
required processing. 
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WSDM Put 
Mainline 
(Chart 4.4.1) 


SSP-ICF Data 


Calling Management 
Program 

via Fast WSDM 

Transfer Router 

SVC (#_DWDM) 


ry W r e 
Instruction Termination ork Station 


Error Recovery 


WSDM Get 
Mainline 
(Chart 4.4.2) 
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Work Station Data Management Put Processing 

A put operation sends a text stream to the work station 
display. If it is a formatted put, a screen format is read 
from disk or from SWS into the buffer area, and the 
task’s variable data is inserted in the appropriate places. 
Work station data management put processing proceeds 
in the following general sequence: 


« Stop outstanding invites. 


- If formatted put, locate format via format index and 
merge the user's logical buffer with format. 


¢ Set up put or put with invite op code in TUB, point 
XR1 at TUB, and issue request to work station 
IOCH. 

e« Return to caller. 

If fields in the format were specifically defined as such 

with indicators, the application program can modify 

fields (display attributes) in the format using the put 


override operation. 


The following work station data management put 
processes are shown in Chart 4.4.1: 


1 Perform initial processing for put operations: 


¢ Set up for formatted or unformatted put 
operation. 


e Stop outstanding invites. 


e Route (within #WDDA) for required detail put 
processing. 


2 Set up for the following, as required: 


¢« Logical |/O save/restore. 


e Save/restore RAM contents list (EXTN task 
only). 


e Write error output. 
e Roll output operation. 


« Clear output operation. 
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10 


11 


e Erase operation. 
e Reset keyboard. 


e Print operation to assigned work station printer 
(in conjunction with a put operation). 


e« Issue halt by calling #WDDQ. 

Do the following, as required: 

e Issue halts. 

« Retrieve format MICs. (If EXTN characters, 
translate them to work station controller storage 


addresses.) 


If requested, process get request in conjunction with 
put operation. 


If pass-through display station request, process it. 


If distributed host command facility request, process 
it. 


If remote display station request, process it. 
Write to local display station as required. 
Print screen to specified printer: 

e Determine printer TUB to use. 

e Allocate and open DIF for printer. 

e Read screen into buffer. 


e Scan for EXTN characters and translate them to 
work station controller storage addresses. 


e Print screen to specified printer. 
e Return to WSDM. 


Process H specifications defined by format, or 
update help list for clear screen. 


Scan for EXTN characters and translate them to 
work station controller storage addresses. 
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WSDM Router 
(Chart 4.4.0) 
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Support 
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Message Retrieve 
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WSDM Get Subroutines 
WSDM Put Mainline (4WDDQ) 
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Work Station Data Management Get Processing e Stop outstanding invites. 


Work station data management get processing is 4 Process get request in conjunction with put 
normally started when the operator presses the Enter operation. 

key or a valid command key in response to an invite 

issued by #WDDA. When an MRT program expects 5 Perform the following, as required: 

input from any of its attached display stations, it issues 

its equivalent of a get, the accept operation. Work ¢ Process low-level request for the Help key. 
station data management get processing proceeds in the 

following general sequence: ¢« Process Print key requests by calling #WDDK. 
e If not already set, set the invite bit on. e Perform function key masking. 

¢ Set up READ op code in TUB, point XR1 at TUB, e lIssue message for Print key requests. 


and issue request to work station IOCH. 
6 If pass-through display station request, process it. 
e Move data that was placed in physical buffer by 
WSIOCH to user's logical buffer. 7 — If distributed host command facility request, 
process It. 
e Return to caller. 
8 If read request is for remote display station, 
The following work station data management get process It. 
processes are shown in Chart 4.4.2: 
9 Process read request for local display station. 
1 Perform the following processing: 
10 Process Print key requests by doing the following: 
e If requested, perform release operation. 
e Determine TUB requested. 
e Route (normally within #WDDG) for required get 


processing. e Determine required formatting. 
Note: For an input operation, #WDDG waits for the e Read screen. 
operator to press a valid key (Enter key or an 
enabled command or function key). If an invalid key e Write data to TWA. 
is pressed, #WDDG continues to wait for a valid 
key, with no return to the calling program. e Attach the Print key task (2#WDDP). 
2 Perform the following, as required: 11. Print the screen image. 
¢ Logical |/O save/restore. e Read data from TWA. 
« Save/restore RAM contents list (EXTN task e Scan user record for the presence of 
only). ideographic characters (work station controller 
storage addresses) and translate them to EXTN 
e Reset keyboard. characters. 
3 Perform the following, as required: e Allocate printer and open DTF. 
« Acquire work station. e Print data. 


¢ Get work station attributes. 
e Extended get work station attributes. 


° Issue halts. 
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12 If Help key is pressed and help areas are defined, do 14 Write to remote display as needed on write error. 
the following: 


15 Write to local display as needed on write error. 
e If cursor is within help area, transfer TUB to 


help task. 16 Scan user record for the presence of ideographic 
characters (work station controller storage 
e Return to #WDDH. addresses) and translate them to EXTN characters. 
13 Display appropriate help formats for application help 17 Browse through an online document. 
request. 


18 Perform cleanup for help task abnormal termination. 


WSDM Router EXTN Task 


(Chart 4.4.0) Save /Restore RCL 


(#GASR) oe 


Miscellaneous 
Subroutines 
(#\WDDB) 


WSDM Miscellaneous 
Subroutines 


(#WDDQ) 
WSDM Put 


Mainline Message Retrieve 
(Chart 4.4.1) Display Station g 
Pass-through 
Support 


Distributed WSDM Print Key 
Host Command (#4WDDK) 
Facility Support 


WSDM WSDM 


Get 
Mainline Remote Work 
(#WDDG) Station Support 


Function WSDM Screen 
Key Print Task 


(#WDDH) 


Help Key 
Control Storage Processor 


(#HPKP) 


Help Transient Application Help 
(#HPLM) Document Processor 
(HHPDO) 


WSDM IGC EXTN Task 

Support Mainline Help Abnormal 

(#WDIGC) (#GAML) Termination 
(#HPDA) 
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PRINT SPOOLING SUBFUNCTION 


The print spooling feature intercepts printer requests and 
places them on disk, creating a spool file. When 
requested, the spool writer retrieves records from the 
spool file and sends them to the printer. 


Chart 4.5.0 shows the overview control flow for print 
spooling: 


Spool IPL 
Processing 
(Chart 4.5.1) 


System Initialized 
for Print Spooling 


Printer Data 
Management 
(Chart 4.3.1) 


Spool Intercept 
(Chart 4.5.2) 


User Program 
Requests 


Entries in 
Spool File 


Spool Control 
Commands via 
Command Processor 


Spool Writer 
(Chart 4.5.3) 
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Chart 4.5.0 Print Spooling Overview Control Flow 
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Spool IPL Initialization 


Spool IPL initialization processes IPL overrides for 
spooling. The overrides provide for deactivating print 
spooling, deleting spool files, formatting spool files, and 
attaching the spool writers if autowriter is selected. 
Spool IPL initialization runs as a command processor 
subtask. 


The following spool IPL initialization processes are 
shown in Chart 4.5.1: 


1 Activate or deactivate print spooling by routing for 
the following: 


Post Sign-On 
Initialization 


Spool WDB 
Builder 
(#4SPWDB) 


Special Allocate 


Spool IPL 
Initialization 


(#MSSP) Special Deallocate 


Spool Writer 
Attach 
(FSPATW) 


Command Processor 
Cleanup 


Job Queue 
Initialization 
(#MSJQ) 


Chart 4.5.1 Spool IPL Initialization Control Flow 


If print spooling is to be activated, build the writer 


descriptor blocks (WDBs). 


If first extent of spool file (##SPOOL1) must be 
allocated, allocate new disk file. 


If any spool file extents must be deallocated, 
deallocate the disk files. 


If autowriter was specified, start the spool writer; if 


necessary, attach the spool writer task. 
Issue any required messages. 


Exit to initialize job queue. 


Task Attach 
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Spool Intercept 


Spool intercept saves data in the spool file when it is 
called by the printer data management spool intercept 
router (HSPRT). The call from the router comes via 
printer data management (HDPDM), to which spool 
intercept is linked. Spool intercept processes 
transparent mode records (records prepared in 

detail by a low-level-language user program) or 
nontransparent mode records (normal). 


Printer data management (HDPDM) may preprocess 
records passed to spool intercept (#SPINT): 


e If XR2 points to a DTF and it is not a transparent 


mode or a get printer status request, preprocessing 


was done by #SPRT. Printer data management 
branches directly to spool intercept. 


« If XR2 contains hex OOO000, no DTF is passed and 


no printer data management preprocessing is 


The following spool intercept processes are shown in 
Chart 4.5.2: 


1 Save the spooled records in the spool intercept 
buffer; write the full spool intercept buffer to the 
spool file. 


2 When necessary, allocate another spool file segment 
when the current segment is full. 


3 Allocate another spool file extent when all segments 
of the current extents are full. 


4 Allocate spool file space when a new print file is 
opened. 


5 If DEFER-NO print data, attach the spool writer to 
start printing the data. 


6 If the spool writer is started, create the spool writer 
task. 


required. Printer data management branches directly 


to spool intercept. 


¢« If neither of the above conditions is true, printer 


data management preprocesses the records before 


branching to spool intercept. 
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7 ~~ Allocate the first spool file segment for the new 
print file. 


8 Issue any required messages. 
9 Route message to appropriate display station. 


10 If option 2 was selected in response to a message, 
close the spool file entry. 


11. If an error was detected, close the spool file entry. 


12 If DTF was passed to spool intercept, set 
completion code. 
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Chart 4.5.2 Spool Intercept Control Flow 
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Spool Writer 


The spool writer reads print data from the spool file and 
routes it to a printer. The spool writer is controlled by 
the spool control commands. When active, there is a 
separate spool writer task for each printer configured on 
the system. Each spool writer can be started and 
stopped by spool commands or can be run under the 
autowriter (automatic start). When there are no more 
entries on the spool file for a given writer, the writer 
goes to end of job. 


Spool Writer Region Map 


The following table shows the locations of key data 
areas involved in the spool writer subfunction: 


Dump 
Address 
(in Hex) Contents 


0800 
1000 Spool writer (ZSPWRT) 


2800 TWS miscellaneous fields and save 
areas 


2COO TWS spool print file control sector save 


area 


2D00 Print buffer 
2E0OO Print buffer overflow area 
2FOO Disk buffer for spool file blocks 


3900 Unused storage 
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The following spool writer processes are shown in Chart 


4.5.3: 

1 Create the spool writer tasks. 

2 Find and update the print file being used by the 
spool writer. 

3. If required, allocate the appropriate printer for the 
spool writer being activated. 

4 Initialize the printer for the current print file. 

5 Read a block of data to TWS buffer. 

6 If ideographic characters are to be printed on a 
nonideographic printer, set the ideographic 
characters to blank. 

7 ‘If ideographic characters require extended character 
processing before being printed, process them. 

8 Send the print data: 

e Ifthe printer is an IPDS printer, call the 
intelligent printer facility (IPF). 

¢ lf the printer is locally attached, print data on 
the appropriate local printer. 

e« If the printer is remotely attached, send the 
print data to the appropriate remote printer. 

9 If required, put a time stamp in the history file. 

10 Issue any required messages. 

11 Route the message to the appropriate display 
station. 

12 If required, purge any outstanding SYSLOG 
messages. 

13 If required, purge any outstanding printer error 
messages. 

14 When all data is printed, terminate task. 
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Chart 4.5.3 Spool Writer Control Flow 
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SECTOR DATA MANAGEMENT TO DISK 
SUBFUNCTION 


Sector data management provides privileged users with 
the capability of moving considerable amounts of data 
to or from disk. It uses a single input/output buffer that 
is filled by a single read operation, or is written to disk 
with a single write operation. Sector data management 
is loaded by disk open and is user-invoked by passing 
control to the address at which sector data management 
was loaded. 


The following sector data management processes are 
shown in Chart 4.6: 


1 Prepare to read or write disk data. 


2 Process read or write operations for an entire block 
of data. 


3 Set DTF completion code . 


Sector Data Control Storage 
Management to 

Disk 

(#DDSM) 


Privileged User 


$0590142-0 
Chart 4.6 Sector Data Management to Disk Control Flow 
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KEYSORT SUBFUNCTION 


Keysort arranges indexed disk file index entries in 
ascending order based on the value of the index entries. 
Keysort is a logical transient invoked via the transfer 
SVC, with XR2 pointing to a 16-byte keysort parameter 
list in system queue space (SQS). The parameter list 
points to the file format 1 which describes the index to 
be sorted. All direct users of keysort are SSP privileged 
programs, but end users can evoke keysort through the 
keysort utility (described in SSP Utilities EE. 


The following keysort processes are shown in Chart 4.7: 


1 Perform presort processing: 


Analyze parameter list and format 1 to 
determine level of keysort required. 


Initialize keysort common area. 


Design sort or merge, based on internal sorting 
area, buffer allocation, and disk work space. 


Allocate disk work space, if needed and if 
available. 


Return to keysort control. 


2 Perform sort with work file: 
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Perform sort phase 1: Build internal sort 
strings. 


Perform sort phase 2: Merge sort strings 
generated by phase 1 into larger and fewer 


strings. 


Perform sort phase 3: Final merge. 


3 Perform merge only. 


4 Perform sort without a work file. 


5 Do the following post sort processing: 


e Free resources. 


e Set appropriate return information in parameter 


list. 


e Adjust format-1 values according to keysort 


performed. 


e Reinitialize data management control blocks as 


required. 


e« Return to keysort control. 


6 ‘If an error is detected in presort processing, issue 


MIC 0390 to terminate the task. 
7 ~~ Report duplicate keys to user. 


8 Return to caller. 
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Users: 
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TAPE DATA MANAGEMENT 


Tape data management performs record mode tape file 
processing. Device-to-device data transfers involving 
tape are performed using Tape Save/Restore Gi. 


Tape data management consists of the following 
functions: 


e Tape find 
e Tape get 
e Tape put 
e Tape add 


Tape Find Data Management (#TAFND) 


Tape find data management finds file labels using the 
name passed by the user. When it finds a label, tape 
data management moves the header label for the 
specified file from the physical buffer to the user's 
logical buffer and moves the block count from the trailer 
label into the tape DTF. When another request for the 
same label name is received, tape data management 
finds the header label for the next file of that name and 
returns its label in the logical buffer and its block length 
in the tape DTF. 
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Tape Get Data Management (#TAGET) 


Tape get data management uses one of two #TAGET 
routines, depending on the user region size. If the user 
region is large enough, tape get data management reads 
the full block into the physical buffer, then moves the 
applicable record from the physical buffer to the user’s 
logical buffer each time a get request is issued. If the 
user region is not large enough, tape get data 
management reads part of the block into the physical 
buffer, then moves the applicable record from the 
physical buffer to the user’s logical buffer each time a 
get request is issued. 


When an end-of-volume condition is returned on a read 
block, #TAGET loads the end-of-volume processing 
module to get the next tape that is mounted. When 
#TAGET receives control again, it continues reading 
blocks of data and processing get requests. 


When a file is out of data, #TAGET sends an EOF 
completion code to the caller. Because the data storage 
controller has already read the trailer labels, no further 
processing is required of the caller. 


Tape Put Data Management (#TAPUT) 


Tape put data management uses one of two #TAPUT 
routines, depending on the user region size. If the user 
region is large enough, tape put data management 
builds a full block in the physical buffer, by moving data 
from the logical buffer into the physical buffer. When 
the physical buffer is full, #TAPUT writes the block to 
tape. If the user region is not large enough, #TAPUT 
moves records to the physical buffer until the next full 
record will not fit into the buffer. When a full record will 
not fit into the physical buffer, part of the record is 
moved to the physical buffer, then the physical buffer is 
moved to the data storage controller (hardware) buffer. 
After the move, the part of the record remaining in the 
logical buffer is moved to the physical buffer. When the 
last move from the physical buffer into the hardware 
buffer fills the hardware buffer to the size of the block 
length, the hardware buffer is written to tape. 


When an end-of-volume condition is returned on a 
write block, the block and its EOV trailer labels have 
already been written to tape by the data storage 
controller. #TAPUT loads the EOV module to get the 
next tape that is mounted; on return from EOV, #TAPUT 
returns control to the user. 
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Tape Add Data Management (#TAADD) 


Tape add data management uses one of two #TAADD 
routines, depending on the user region size. If the user 
region is large enough, tape add executes user add 
instructions by moving a record from the logical buffer 
to the physical buffer. When the physical buffer is full, 
#TAADD requests the data storage controller to write 
the block to tape. 


If the user region is not large enough, #TAADD moves 
records to the physical buffer until the next full record 
will not fit into the buffer. When a full record will not fit 
into the physical buffer, part of the record is moved to 
the physical buffer, then the physical buffer is moved to 
the data storage controller (hardware) buffer. After the 
move, the part of the record remaining in the logical 
buffer is moved to the physical buffer. When the last 
move from the physical buffer into the hardware buffer 
fills the hardware buffer to the size of the block length, 
the hardware buffer is written to tape. 


When an end-of-volume condition is returned on a 
write block, the block and its EOV trailer labels have 
already been written to tape by the data storage 
controller. #TAADD loads the EOV module to get the 
next tape that is mounted; on return from EOV, 
#TAADD returns control to the user. 


Tape Read Block Data Management (#TARBK) 


Tape read block data management uses one of two 
#TARBK routines, depending on the user region size. If 
the user region is large enough to contain it, tape read 
block data management reads the full block into the 
physical buffer each time a get request is issued. If the 
user region is not large enough, tape read block data 
management reads part of the block into the physical 
buffer each time a get request is processed. 


When an end-of-volume condition is returned on a read 
block, #TARBK loads the end-of-volume processing 
module to get the next tape that is mounted. When 
#TARBK receives control again, it continues reading 
blocks of data and processing get requests. 


When a file is out of data, #TARBK sends an EOF 
completion code to the caller. Because the data storage 
controller has already read the trailer labels, no further 
processing is required of the caller. 
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Tape Write Block Data Management (#TAWBK) The following tape data management processes are 


shown in Chart 4.8: 
Tape write block data management uses one of two 


H#TAWBK routines, depending on the user region size. If 1 Perform tape data management services: 

the user region is large enough, tape write block data 

management writes a full block from the physical buffer e Initialize for user request. 

each time a put request is issued. If the user region is 

not large enough, tape write block data management e Check for end of data. 

writes part of the block into the physical buffer each 

time a put request is processed. « Issue SVCs for tape data storage controller. 
When an end-of-volume condition is returned on a e If end-of-volume processing is required, start 
write block, #TAWBK loads the end-of-volume it; otherwise, set DTF completion code and 
processing module to get the next tape that is mounted; return to user. 

on return from EOV, #TAWBK returns control to its 

caller. 2 Perform end-of-volume processing: 


e Unload tape drive that has an end-of-volume 
condition. 


« If AUTO-YES was specified and another drive 
can be allocated, use other tape drive. 


e Verify volume label and header labels; if 
incorrect, issue error message. 


Tape Data Management Control Storage 
(ATAGET, #TAPUT, 
#TAADD, #TAFND, 

Calling #TARBK, #TAWBK) 

Program Data Storage 


via Branch Controller 
Instruction (DSC) 
Tape Interface 
End-of-File 
Processing 
(#TAEOV) 


$0590364-0 
Chart 4.8 Tape Data Management Control Flow 
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1255 MCR DATA MANAGEMENT « Determine request type and initialize |OBs, 
action control elements or error recovery blocks 


User programs access 1255 MCR data management required. 

through one of two IBM-supplied user interface 

subroutines, SUBRO8 or SUBR25. In earlier systems, ¢ Route for the following, as required. 

the two subroutines were packaged separately; both 

subroutines are provided on System /36 to maintain 2 Perform open processing for 1255 MCR requests: 
compatibility among systems. The subroutines build 

1255 MCR DTFs which they pass (via XR2 pointer) to ¢ Open DTF. 

the data management modules via transfer SVC 

instructions. In the control flow chart, two module e Load 1255 controller. 

names are given for each module's descriptive name. 

The name listed first is the module used with the 3. Process 1255 MCR IOBs. 

SUBRO8 subroutine; the second name is the module 

used with the SUBR25 subroutine. 4 Perform 1255 MCR error recovery: 

The following 1255 MCR data management processes ¢ Process error |OB pointed to by XR1, and 
are shown in Chart 4.9: parameter list pointed to by XR2. 

1 Perform the following for 1255 MCR requests: ¢ Issue any required messages via message 


retrieve and SYSLOG 6 | 
e Map to data area used in common with control 


storage MCR programs. 


e Set up DTF data buffer. 


User Program 2 


Control Storage 


1255 MCR 
Open 
(4MION/#MRON) 


| 
MCR Controller 
Loader 
(SMRALD) 


1255 MCR 
User Program Data 


Subroutine Management 


(SUBRO8/ (#4MIML/#MRML) 
SUBR25) 


MCR IOCH 


($MRF) 
1255 MCR 


Error Recovery 
(#MERP/#MRER) 


$0590365-0 
Chart 4.9 1255 MCR Data Management Control Flow 
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OFFICE/36 SUPPORT SUBFUNCTION 


OFFICE/36 support provides data management folder 
support for the following products: 


¢ Interactive data definition utility (IDDU) 
© Query/36 
¢ Personal Services/36 (PS/36) 


¢ DisplayWrite/36 (DW/36) 


OFFICE/36 support consists of the following: 
« Office systems transforms and profiles processors 
¢« Folder management services (FMS) 1/O router and 


miscellaneous processing 


The office systems transforms processor allows the 
office support utilities to communicate with each other 
and with FMS by translating between the DW/36 


internal data format and the data formats used by other 


utilities; the office systems profiles processor provides 
for the maintenance of screen defaults and other user 


information that can be retrieved for use during an office 


system session. FMS provides support that allows the 
utilities and users to create, edit, delete, copy, and list 
the special libraries, members, and records (folders, 
documents, and data items) used by the OFFICE/36 
program products. 
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Chart 4.10.0 shows the overview control flow for the 
OFFICE/36 support subfunction: 


Resource Security 


Edit Detail FMS 


Processing 


Distributed Data 
Management 
(Chart 4.11.0) 


FMS 
Utility 
Functions 
(Chart 4.10.4) 


Work Station 
Error Recovery 


Query /36 


IDDU 
(Chart 8.36.0) 


FMS 1/0 
Router 
(Chart 4.10.3) 


Library Access 
Method 


Text Conversion 
Aid 


Office Systems 
Profiles Processor 
(Chart 4.10.2) 


Office Systems 
Transforms Processor 


(Chart 4.10.1) 


PC Exchange 


Utility 


Virtual Disk Disk Data 


Access Method Management 


$0590409-5 


Chart 4.10.0 OFFICE/36 Support Overview Control Flow 
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Office Systems Transforms Processor 


The office systems transforms processor converts an 
input data stream of one type to an output data stream 
of another type. The processor allows for the 
interchange of data among the OFFICE/36 program 
products and folder management services (FMS), and to 
and from |/O devices. The office systems transforms 
processor is called via a transfer SVC instruction and 
parameter list by the following: 


e PS/36 

« DW/36 

¢ Text conversion aid 
e PC exchange utility 


The processor provides only the conversion capability 
and does not open or close the affected files, 
documents, or devices; in addition to being responsible 
for these, the caller must also interlock files or 
documents to prevent their modification during the 
transformation. The caller must position the input data 
stream pointer so the next read/get provides the 
information required for the conversion. 


The transforms processor converts between internal 
DW//36 data stream format and several other external 
types of data streams. It can also convert between 
several external formats, but all conversions of this type 
require an intermediate conversion to/from the internal 
DW/36 data stream format. The DW/36 data stream 
format is compatible with System/36 SSP and the FMS 
librarian functions. 
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The following office systems transforms processor 
processes are shown in Chart 4.10.1: 


1 Initialize for transforms processing: 


e Initialize transforms common area 
(TTCOMMON). 


e Map to parameter list and check it for errors. 
¢ Build any required FMS members. 


2 Use parameter list to determine required routing; 
route control to appropriate Conversion processor. 


3 Convert for alternative character set. 


4 Convert data in source or procedure to DW/36 
internal format. 


5 Convert text from System/36 Release 1 TMS 
format to DW/36 internal format. 


6 Convert text from FFT-DCA to DW/36 internal 
format. 


7 Convert text from DW/36 internal format to 
FFT-DCA. 


8 Convert text from RFT-DCA to DW/36 internal 
format. 


9 Convert text from DW/36 internal format to 
RFT-DCA. 


10 Convert text from DW/36 internal format to SCS#1 
format. 


11 Convert text from DW/36 internal format to SCS#2 
format. 


12 Convert text from DW/36 internal format to 
WP/EBCDIC format. 
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DW /36 Format to 
Alternative Character 
Set Processor 
(#TTAC) 


PS/36, DW/36, 
Text Conversion 
Aid, or 

PC Exchange 
Utility 

(See Section 3, 
SSP Interfaces) 


Source-to-DW/36 
Format Processor 
(#TTGR) 


Text to DW/36 
Format Processor 
(#TTPR) 


FFT-DCA to DW/36 
Format Processor 
(#TTIM) 

DW /36 Format to 
FFT-DCA Processor 
Office Systems (ATTJM) 
Office Systems Transforms Root 
Transforms Root Phase 2 

Phase 1 (4TTR1) 

(#TTRT) 


RFT-DCA to DW/36 
Format Processor 


DW //36 Format to 
(ETTKR) Soaks 


RFT-DCA Format 
Processor 
(#TTLR) 

DW/36 Format to 
SCS#1 Format 
Processor 
(#TTSA) 

5224 /5225/4214 
Printers 


DW //36 Format to 
SCS#2 Format 
Processor 

(#TTSS) 
3262/5256 Printers 


DW /36 Format to 
WP/EBCDIC 
Processor 
(#TTWP) 
6670 Printer 


DW //36 Format to 
Print File 


Processor 
(#TTFR) 
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Chart 4.10.1 Office Systems Transforms Processor Control Flow 
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Office Systems Profiles Processor e Get user profile. 


The office systems profiles processor provides for the e Put user profile. 
maintenance of profile folders and user profiles that 

contain screen defaults and other user information. The ¢ Delete user profile. 

profile folders and user profiles are invoked at sign-on 

time to customize the operator's interface to office e Archive/retrieve user profile. 
services. 


¢ Save/restore profile folder. 
The office systems profiles processor performs, or 
routes for, the following processes: ¢« Reorganize/extend profile folder. 


e Create profile folder. « Delete profile folder. 


« Create user profile. 


DW/36 


(See Section 3, 
SSP Interfaces) 


Folder 
Management 


Office Systems 


Profiles Processor Services |/O 


Router 
(Chart 4.10.3) 


(#TPMA) 


PS/36 


(See Section 3, 
SSP Interfaces) 


$0590417-1 
Chart 4.10.2 Office Systems Profiles Processor Control Flow 
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Folder Management Services (FMS) 

Folder management services (FMS) provides the 
OFFICE/36 program products and associated functions 
with an interface to the local system document folder 
for the following purposes: 

e Folder and member open and close 

e Folder and member data processing support 

e Data descriptor processing support 

e Text data processing support 

e Associate record processing support 

Folder management services consists of the following: 
e FMS 1/O router 

e FMS utility functions 

FMS can be invoked via an SVC instruction interface 
(privileged) or through procedure calls. The procedure 
interface allows users to directly maintain information 
contained in the document folders. System procedures 
are executed by the FMS utility, described in SSP 
Utilities, Chart 8.35. The FMS utility uses the privileged 
(SVC) interface described below. 

The SVC interface uses a parameter list to pass data 


and operation codes to FMS, and to pass return codes 
and data back to the caller. 
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Calling programs use the following data areas to 
interface to FMS processing: 


1/O PARAMETER LIST: Each request for a FMS I/O 
operation must be accompanied by an |/O 
parameter list. The list includes an 
operation code and information on the 
attributes of the data to be used in 
conjunction with the requested operation. 


DATA DESCRIPTOR AREA (DDA): The DDA is a 
portion of a folder that contains 
product-defined attributes of the data 
contained in the folder; the attributes 
describe the folder data down to the field 
level. The DDA also includes a summary 
description of the data for the benefit of 
operators scrolling folders. 


DATA DESCRIPTOR AREA (DDA) LIBRARY HEADER: 
The DDA library header consists of the 
library description, the library validation 
data, and the DDA-type headers for the 
folder. 


DATA TEXT AREA (DTA): The DTA stores the actual 
member text and any associated data. The 
text is broken into text record units that 
serve as page break units, format change 
units, and/or line units. The text record 
units are accessed via an allocation map 
located at the front of the DTA. The DTA 
also contains associate records (which 
contain IDDU fields, formats, and file 
information), DW/36 format descriptions, 
and other miscellaneous product-defined 
information. 
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FMS 1!/O Router 

The folder management services |/O router performs all 
|/O associated with folders and documents. Callers 
invoke FMS I/O with a fast transfer SVC instruction and 
a TMIO parameter list. 


Chart 4.10.3 shows the following FMS I/O control flow: 


1 Set up parameter list and transfer to detail |/O 
function requested. 


2 Open folder by protecting resources, allocating 
folder, and writing open folder flag to disk. 


Open member by locking folder and type, setting 
open member flag in physical directory, and 
checking member security and security fields in 
DDA. 

3 Close folder: 

¢« Lock folder and type. 

« If folder was opened for CREATE and closed 
with UPDATE-NO, delete any member that was 
created. 

e Write type headers and allocation maps to disk. 

« Deallocate folder. 

4 Get and lock DDA. 

5 Retrieve information about a member's text data. 

6 Get text lines or text units by page and line number. 
7 Get associate record. 

8 Read associate record into caller's buffer. 

9 Put DDA. 

10 Put text units to FMS member. 


11 Write buffer contents as an associate record. 


12 Delete one or more lines in a member. 


14 


15 


16 


17 
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Delete associate record or group of associate 
records. 


Lock, list, and unlock one or more DDAs. 


Lock, search (using search argument), and unlock 
one or more DDAs. 


Continue search when #TMSDD successful search 
list is too long for user to process in one call. 


Build replacement DDA with space for more data in 
all (or in specifically requested) areas. 
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Caller via Fast 
Transfer SVC 


Instruction with 
TMIO Parameter 
List 


FMS 1/O 
Router 
(ATMIO) 


(continued) 


Security 
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Folder /Member 
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(ATMOPN) 


Delete Member 
(ATMMDT) 
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(#TMGDD) 


Get Text Record 
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(#TMGIT) 
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Record 
(ATMGAR) 
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Chart 4.10.3 (Part 1 of 2) FMS I/O Router Control Flow 
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(continued) 
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Chart 4.10.3 (Part 2 of 2) FMS 1/O Router Control Flow 
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FMS Utility Functions Processing 


Folder management services utility functions processing 
consists of individual modules that are directly called by 


the office systems utilities and related components via 
transfer SVC instructions and parameter lists. 


The following FMS utility functions processing is shown 


in Chart 4.10.4: 


Delete a member from a folder, delete the text 
portion (DTA) member of a folder, or delete a 
member without deleting the physical directory 
entries. 


2 Rename a member within a folder. 
3 Copy a member, creating a new member or 
replacing an existing member. 

4 List information about a folder or group of folders. 
5 Reorganize folder increasing or decreasing size or 
removing as much unused space as possible. 

6 Save a folder to a diskette or tape file. 

7 Restore a saved folder from a diskette or tape file. 

8 Archive a member from a folder to a diskette or 
tape file. 

9 Retrieve an archived member from a diskette or 
tape file. 

10 Create a new folder on disk. 

11 Create a DTA for a folder and set up allocation map 
for DTA. 

12 List information about an archived member on the 
SYSLIST device. 
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FMS Member 


Delete M 
(#TMMDT) FMS Member 

Rename 

| . (ATMMRN) and 
FMS Copy 
Member : 
FMS List 

(#TMCPY) fe 


Folder 
(#TMLST) FMS Subroutines 


(#TMSR) 


IDDU, PS/36, 
and DW//36 


FMS Reorganize 
Folder 
(4TMRORG) 


and/or 


FMS Save 
Folder 
(#TMSV) 


via FMS |/O Router 


(Chart 4.10.3) 


FMS Utility 


FMS Restore 
Folder 
(4TMRS) 


FMS Archive 
Member 
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Member 
(ATMRTV) 
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Folder 
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Chart 4.10.4 FMS Utility Functions Processing Control Flow 
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DISTRIBUTED DATA MANAGEMENT (DDM) 


Distributed data management (DDM) allows the user to 
access remote files as if they were local files. DDM 
operates only within an APPC subsystem environment 
using LU6.2 and allows access only to data files. 


For the purposes of this description, DDM is broken into 
two main components: source processing and target 
processing. Source DDM (SDDM) processing makes the 
complexity of accessing remote files transparent to the 
requesting procedure or program; target DDM (TDDM) 
processing makes file access requests received from 
other systems appear to SSP as local requests. 


DDM uses the system’s network resource directory 
(NRD) file to determine where requested files reside. 
Each system in a DDM network has its own NRD that 
contains entries for all remote files to which its local 
users have access. Each NRD entry contains the file 
name by which the file is known locally, the symbolic ID 
of the remote system on which the file resides, and the 
file name by which the file is identified to the remote 
system. 


When DDM finds a NRD entry for a requested file (file 
is remote), DDM source processing communicates the 
file request to the remote system’s DDM target 
processor, via the APPC subsystem. Requests for 
remote files can cascade through several systems before 
the ultimate target system processes the file request. 


Note: The user can edit, save, restore, delete, and list 
the NRD using the network resource directory utilities. 
Refer to SSP Utilities [EJ for more information on the 
NRD utilities. 
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DDM overview 
Source DDM VTOC extract 
Source DDM RENQ/RDEO 


Source DDM initiator support 
processing 


Source DDM runtime processing 
Source DDM rename processing 


Source DDM build index 
processing 


Source DDM delete processing 


Source DDM file transfer 
processing 


Source DDM cleanup processing 


Release 3 and Release 4 target 
DDM mainline processing 


Release 5 target DDM mainline 
processing 


Release 3 and Release 4 target 
DDM VTOC extract 


DDM trace processing 


This topic is organized according to the following: 


Chart 4.11.0 


Chart 4.11.1 


Chart 4.11.2 


Chart 4.11.3 


Chart 4.11.4 


Chart 4.11.5 


Chart 4.11.6 


Chart 4.11.7 


Chart 4.11.8 


Chart 4.11.9 


Chart 4.11.10 


Chart 4.11.11 


Chart 4.11.12 


Chart 4.11.13 


Chart 4.11.0 shows the overview control flow for the 


distributed data management subfunction: 


Local Program or 


Procedure Request 


Local SSP 


Source DDM Processing 
(Chart 4.11.1 through 
Chart 4.11.5) 


SSP-ICF 
Data Management 


Local APPC Subsystem 


LocalC/SNA [Jj 


and DLC Ey 


Remote DLC Ei 


and C/SNA 10} 


Remote APPC 
Subsystem 


Remote SSP-ICF 
Data Management 


Target DDM Processing 
(Chart 4.11.6 and 
Chart 4.11.7) 


Remote SSP 
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Chart 4.11.0 Distributed Data Management (DDM) Overview Control Flow 
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Source DDM (SDDM) VTOC Extract 2 Get network resource directory (NRD) entry for 
requested file from NRD.FLE file: 
SSP VTOC access [J calls SDDM VTOC extract via a 


transfer SVC instruction when it cannot find a VTOC e Use control storage disk IOS to search NRD file 
entry for the requested file and has determined that for local label of remote file. 

remote file access is allowed. SDDM VTOC extract finds 

the NRD entry in the network resource directory for the e If entry not found, set not-met return code and 
requested file; the NRD entry contains either the return to caller. 

symbolic ID of the remote location on which the file 

resides or the symbolic ID of a remote location that e If existence test specified, set normal return 
contains an NRD entry for the file. SDDM VTOC extract code and return to caller. 

returns all requested information to the caller of SSP 

VTOC access via the VTOC access parameter list and e If read function specified, return the remote 
the user buffer. label, length of remote label, and the remote 


location to the caller. 
The following SDDM VTOC extract processes are shown 
in Chart 4.11.1: 3 Process requests from SDDM extract and SDDM 
communications initialization: 
1 Process VTOC access parameter list file request: 
e Acquire an APPC subsystem session. 
e Route control to NRD access to find file label 


specified. e Evoke TDDM mainline. 
e If file label not found, consider local file and e Process puts and gets between SDDM extract 
return to the caller of VTOC access. and remote system's TDDM mainline. 
e If file label found, queue an NRD entry lock 4 Attach TDDM at remote location: 
(NEL) control block to ensure proper locking of 
the NRD entry. e Queue a remote file session (RFS) control block 
to the JCB. 
« If request is test-for or read format 1: 
— Route control to SDDM communications e Acquire an APPC subsystem session. 
initialization to attach the target distributed 
data management (TDDM) at the remote ¢ Evoke TDDM mainline. 
location. 
— lf remote system is a Release 3 and e Send DDM EXCHANGE SERVER ATTRIBUTES 
Release 4 DDM system, route control to command to TDDM mainline to determine the 
the Release 3 and Release 4 SDDM extract. level of DDM installed at the remote system. 


— Send DDM LIST FILE ATTRIBUTES 
command to TDDM mainline. 


e Alter VTOC parameter list with appropriate data 
and return code, place format 1 in user buffer (if 
requested), and return to caller of VTOC 
access. 
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Control Storage 


VTOC Access L NRD ACCESS 
(#SIVD) 
6 | 


4 | SDDM Communications 
Initialization 
(ARMCI) 


SDDM Extract 
(#RMSX) 


SSP-ICF Data 
Management 


Release 3 and 
Release 4 


SDDM Extract 
2 (#RDSX) a 


Release 3 and 
Release 4 


TDDM Mainline 
(Chart 4.11.10) 
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Chart 4.11.1 SDDM VTOC Extract Control Flow 
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Source DDM (SDDM) RENQ/RDEQ 


Source DDM (SDDM) RENQ/RDEOQ processes local user 
requests for the resource enqueueing or dequeueing of 
remote files. Resource enqueue (RENQ) establishes the 
level of sharing that is to exist between multiple users of 
a remote file. Resource dequeue (RDEQ) removes the 
specified share level for the remote file. 


SDDM RENQ/RDEQ is called via an SVC instruction by 
the initiator [, special allocate [Ej, deallocate Kj, or 
termination [j. 


The following SDDM RENQ/RDEQ processes are shown 
in Chart 4.11.2: 


1 Process resource enqueue/dequeue request: 


¢« Get remote file label and location by calling NRD 
access. 


e If resource enqueue request: 

— If RETAIN-S file, force DISP-OLD. 

— If RETAIN-T or -P, get share level specified 
in FSB. 

— If requester is an NRT program and if the 
APPC subsystem session previously 
established by SDDM extract is not 
available, route control to SDDM 
communications initialization to attach the 
target distributed data management (TDDM) 
at the remote location. Otherwise, use 
APPC subsystem session established by 
SDDM extract. 

— lf remote system is a Release 3 and 
Release 4 DDM system, route control to 
Release 3 and Release 4 SDDM 
RENQ/RDEQ. 

—- Send DDM LOCK FILE command to TDDM 
mainline. 

— If reply indicates a file was successfully 
locked and point FSB to remote file session 
(RFS), increment use count in RFS. 

— Process DDM reply sequence from TDDM 
mainline and pass return code to caller. 

— Queue a remote format-1 extension (RF 1) 
to the format 1. For keyed and alternate 
index files, queue a second RF1 containing 
key definition information to the first RF1. 

— Place the address of the NRD entry lock 
(NEL) in the first RF 1. 
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e If resource dequeue request: 

— If RETAIN-S file, force DISP-OLD. 

— If RETAIN-T or -P, get share level specified 
in FSB. 

— Get RFS for the remote location. 

— Use previously-established APPC 
subsystem session to send UNLOCK FILE 
command to TDDM mainline. 

— Process reply from TDDM mainline and 
pass return code to caller. 

— Decrement use count in RFS whether 
unlock was successful or unsuccessful; 
unbind FSB from RFS. 

— Decrement the enqueue count in the RF 1. 

— If the enqueue count goes to zero, then 
dequeue and free any RF1s queued to the 
F1. 


2 Process requests from SDDM RENQ/RDEQ and 
SDDM communications initialization: 


e Acquire an APPC subsystem session. 

¢ Evoke TDDM mainline. 

¢« Process puts and gets between SDDM 
RENQ/RDEQ and remote system’s TDDM 
mainline. 

3 Attach TDDM at remote location: 

¢ Queue an RFS control block to the JCB. 

e Acquire an APPC subsystem session. 

¢ Evoke TDDM mainline. 

¢ Send DDM EXCHANGE SERVER ATTRIBUTES 


command to TDDM mainline to determine the 
level of DDM installed at the remote system. 
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Caller via 
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Instruction 


3 SDDM Communications 
Initialization 
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SDDM 
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Release 3 and 
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Chart 4.11.2 SDDM RENQ/RDEQ Processing Control Flow 
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Source DDM (SDDM) Initiator Support Processing 


Note: Although the determination of whether a file is 
local or remote is done in some of the modules shown 
below, for the purposes of the following description it is 
assumed that the file has already been determined to be 
remote. For local file processing, refer to Job Start 
Function El. 


Source DDM (SDDM) initiator support processing is 
invoked by SSP OCL statement processing modules 
whenever the file named in the OCL statement is a 

remote file. 


The following SDDM initiator support processes are 
shown in Chart 4.11.3: 


1 Read the next OCL statement. 


2 If SYSIN finds an IF DATAF1 PCE or a file size 
substitution expression, call SDDM VTOC extract to 
obtain the VTOC information about the remote file. 


3 Perform syntax and diagnostics checks on the FILE 
Statement, then do the following: 


¢ Get the file's format 1 using SDDM VTOC 
extract. 


¢ If no format 1 is returned and if DISP-NEW is 
specified, create a new format 1. 


e Mark format 1 and FSB to indicate that file is 
remote. 


« If the FILE statement occurred before the LOAD 


statement, call SDDM RENOQ to send a DDM 
LOCK FILE command to the remote system. 
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4 Process RUN statement by doing the following: 


If RELEASE-YES was specified on the ATTR 
statement (a NRT program is being initiated), do 
the following: 

— Create a new JCB for the NRT and point 
the JCB to the TB. 

— Transfer any non-enqueued FSB(s) from 
the old JCB to the new NRT JCB. 

— Call DDM suspend to suspend DDM 
sessions being used by the old JCB and to 
transfer all unused DDM sessions from the 
old JCB to the new NRT JCB. 


After performing any required NRT processing, 
call DDM RENO for each remote-file-invoking 
FILE statement that occurred after the LOAD 
statement. 


If a diagnostic condition occurs and a remote 
file's lock must be given up, call DDM RDEQ to 
send a DDM UNLOCK FILE command to the 
remote system. 
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5 Process INCLUDE statement for MRT procedures: ¢ \f SSP-ICF data management posted this task to 
indicate an asynchronous APPC subsystem 


e If attaching to an active MRT, call DDM condition, then: 
suspend to suspend DDM sessions acquired for ~— Issue SSP-ICF INVITE operation to clear 
this JCB. post (ACE) from this TB. 


— Set post in RFS. 
e If attaching to an inactive MRT, create a new 


JCB for the MRT and call DDM SUSPEND to ¢« If the new JCB is for a NRT and the use count 
suspend DDM sessions acquired for the old in the RFS is zero, move the RFS from the old 
JCB. JCB to the new JCB. 
6 Process each DDM session owned by the old JCB by Note: If a DDM session is suspended, it will 
doing the following: be resumed when the command processor 
attaches a new task to the old JCB. When the 
e If the use count in the RFS is non-zero or if the new task calls an SDDM module, the SDDM 
new JCB is for a MRT, suspend the DDM module calls its internal subroutine to do the 
session by doing the following: following: 
— Set TB address and task ID in SUB to zero. ~— Store the new TB address and task ID in 
~— Set suspended bit in RFS. the SUB. 


— Reset suspended bit in RFS. 
— If post is the needed bit and is set in RFS, 
post this TB. 


SDDM VTOC 
Extract 
(Chart 4.11.1) 


// FILE Statement 
Processor 


DDM 
RENQ/RDEQ 
(Chart 4.11.2) 


Initiator 


// RUN Statement 
Processor 


DDM Suspend 


(#RMSU) 


// INCLUDE 
Statement 
Processor 
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Chart 4.11.3 Source DDM (SDDM) Initiator Support Processing Control Flow 
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Source DDM (SDDM) Runtime Interfaces e Process DDM reply sequence received from 
remote system’s TDDM open processor. 
During user program execution, other SSP programs 


invoke SDDM functions via SVC instructions e If the file is opened successfully, initialize FAB 
accompanied by appropriate parameter lists. The and calculate the data in FAB for get and put 
following SDDM runtime interfaces are shown in Chart use. 

4.11.4: 


3 Process put or control function request from disk 


1 Process normal or special allocate request passed data management mainline: 


by #CAM2: 


Route control to network resource directory 
(NRD) access module to find entry for file 
requested by caller of allocate. 


If remote system is a Release 3 and Release 4 
DDM system, route control to Release 3 and 
Release 4 SDDM runtime interfaces. 


If request is for the allocation of a new file, 
send DDM CREATE PHYSICAL FILE command 


to target distributed data management (TDDM). 


If request is a load-to-old-file allocate request, 
send DDM RECREATE PHYSICAL FILE 
command to TDDM. 


If request is to clear file, send DDM CLEAR 
PHYSICAL FILE command to TDDM. 


Process DDM reply sequence received from 
remote system’s TDDM allocate processor. 


For all other allocate requests, the file will be 
allocated when the open command is 
processed. Indicate that allocate is successful. 


If the file is allocated successfully, turn on the 
remote indicator in DTF. The file is allocated in 
DTF. 


2 Process open request from #DD2OP: 
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Route control to network resource directory 
(NRD) access module to find entry for file 
requested by the caller of open. 


Convert from disk DTF request to DDM OPEN 
FILE command. 


If remote system is a Release 3 and Release 4 
DDM system, route control to Release 3 and 


Release 4 SDDM runtime interfaces. 


Send OPEN FILE command to TDDM. 


Convert disk data management put request into 
a DDM command. 


If remote system is a Release 3 and Release 4 
DDM system, route control to Release 3 and 
Release 4 SDDM runtime interfaces. 


Send DDM command to TDDM. 


Process DDM reply sequence from TDDM and 
post results to caller. 


Process get request from disk data management 
mainline: 


Convert disk data management get request into 
a DDM command. 


If remote system is a Release 3 and Release 4 
DDM system, route control to Release 3 and 
Release 4 SDDM runtime interfaces. 


Send DDM command to TDDM. 


Process DDM reply sequence from TDDM and 
post results to caller. 


Process close request from #DDCL: 


Convert from disk DTF request to DDM CLOSE 
command. 


If remote system is a Release 3 and Release 4 
DDM system, route control to Release 3 and 
Release 4 SDDM runtime interfaces. 


If deferred output request, send the DDM PUT 
command to TDDM and process DDM reply 
sequence. 


Send DDM CLOSE command to TDDM. 


Process DDM reply sequence received from 
remote system’s TDDM close processor. 
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Normal or Special 
Allocate 


SDDM Allocate 


(#RMSA) 
Release 3 and Release 4 
SDDM Allocate 


(#RDSA) 


Open 2 


SDDM Open 
(ARMSO) 
Release 3 and Release 4 
SDDM Open 
(#RDSO) 
SDDM Put 


(4RMSP) SSP-ICF Data 
Management 
Release 3 and Release 4 


SDDM Put 
(#RDSP) 


Disk Management 


Mainline 
(Chart 4.1.1) 


SDDM Get 


(ARMSG) 
Release 3 and Release 4 


Close SDDM Close 
5 (#RMSC) 
Release 3 and Release 4 


SDDM Close 


Chart 4.11.4 Source DDM (SDDM) Runtime Interfaces Control Flow 


TDDM Mainline 
(Chart 4.11.10 
or Chart 4.11.11) 
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Source DDM (SDDM) Rename ¢ If remote system is a Release 3 and Release 4 
DDM system, route control to Release 3 and 


Source DDM Rename processes a request from the Release 4 SDDM rename. 
calling module to rename a file that resides on a remote 
system. e Send DDM RENAME FILE command to TDDM. 
The following SDDM Rename processes are shown in e Process DDM reply sequence from TDDM 
Chart 4.11.5: mainline and pass return code to the caller. 
1 Process rename request: 2 Get NRD entry for requested file from NRD file. 

e Scan the NRD entry lock (NEL) queue to find the 3 Process requests from SDDM Rename: 


NRD entry for the old file label. 
e Acquire an APPC subsystem session. 
e Route control to NRD access to find the new 


file label. e Evoke TDDM. 
e If file label not found, return an NRD entry not e Process puts and gets between SDDM rename 
found message to the caller. and remote system’s TDDM mainline. 


° If file label found, test the remote location. The 
new file location must be the same as the old one. 


e If request is test-for or read format 1: 

— Route control to SDDM communications 
initialization to attach the target distributed 
data management (TDDM) at the remote 
location. 

— If remote system is a Release 3 and 
Release 4 DDM system, route control to 
Release 3 and Release 4 SDDM extract. 

— Send DDM LIST FILE ATTRIBUTES 
command to TDDM mainline. 


Release 3 and 
Release 4 

SDDM Rename 
(#RDSR) 


Caller via 
Transfer SVC 
Instruction 


SSP-ICF 
SDDM Rename 


(#RMSR) 


Data Management 


SDDM Communications 
Initialization 
(FRMCI) 


DDM NRD Access 
(ASIVD) 


TDDM Mainline 
(Chart 4.11.10 


or Chart 4.11.11) 
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Chart 4.11.5 Source DDM (SDDM) Rename Process Control Flow 
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Source DDM (SDDM) BLDINDEX 


Source DDM BLDINDEX processes a request from the 
calling module to build a remote alternate index file for a 
remote base file. 


The following DDM BLDINDEX processes are shown in 
Chart 4.11.6: 


1 Special allocate the base file. 
2 Process build index request: 


e Scan the NRD entry lock (NEL) queue to find the 
NRD entry for the base file label. 


e Find RFS created when the base file is 
allocated. 


e Route control to NRD access to find the 
alternate index file label. 


e If file label not found, return an NRD entry not 
found message to the caller. 


e If file label found, test the remote location. The 
logical file location must be the same as the 
physical file location. 


e If remote system is a Release 3 and Release 4 
DDM system, route control to Release 3 and 
Release 4 SDDM BLDINDEX. 


Caller via 
Transfer SVC 


Instruction 
SDDM 
BLDINDEX 
(#RMSL) 


Special Allocate 


Chart 4.11.6 Source DDM (SDDM) BLDINDEX Process Control Flow 


e« Send DDM CREATE ALTERNATE INDEX FILE 
command to TDDM. 


« Process DDM reply sequence from TDDM 
mainline and pass return code to the caller. 


3 Get NRD entry for a requested file from the NRD file. 


4 Process requests from SDDM build index. 


DDM NRD 
Access 
(#SIVD) 


Release 3 and 
Release 4 

SDDM BLDINDEX 
(#RDSL) 


SSP-ICF Data 
Management 


TDDM Mainline 


(Chart 4.11.10 
or Chart 4.11.11) 


SDDM Communications 
Initialization 
(4RMCI) 
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Source DDM (SDDM) Delete 3 Abnormal termination is processing a new remote 
file that was allocated by the step. 
Source DDM Delete processes a request from the calling 


module to delete the remote file that resides on a remote 4 Process DDM delete request: 
system. 
e Build and send DDM DELETE FILE command to 
The following SDDM Delete processes are shown in TDDM mainline. 
Chart 4.11.7: 


e Process DDM reply sequence from TDDM 
1  $DELET calls DEALLOCATE (#CAD1) for a delete file mainline and pass return code to the caller. 
request and the file is a remote file. 
e If remote system is a Release 3 and Release 4 
Normal termination is processing an existing DDM system, route control to Release 3 and 
resident remote file that should be deleted at the Release 4 SDDM delete. 
end of the step. 


NO 


(SDELET) 


Deallocate 1 


Release 3 and 
Release 4 
SDDM Delete 


(#RDSD) [QJ 


2 SDDM Delete 


Normal Termination (#RDSD) 


SSP-ICF Data 
Management 


TDDM Mainline 
Abnormal Termination 


(Chart 4.11.10 
or Chart 4.11.11) 
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Chart 4.11.7 Source DDM (SDDM) Delete Process Control Flow 
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Source DDM (SDDM) File Transfer 3 Put the next record for a load file request and pass 


return code to caller. 
Source DDM File Transfer processes a request from the 


calling module to copy an entire file to and/or from a 4 Get the next record for an unload file request and 

remote system. pass record data and/or return code to caller. 

The following SDDM File Transfer processes are shown 5 Terminate the load file or unload file request and 

in Chart 4.11.8: pass return code to caller. 

1 Process a LIST FILE SERVER ATTRIBUTES request. 6 Process the copy file request and pass return code 
Return an indication to the caller whether or not the to caller. 


LOAD FILE, UNLOAD FILE, and COPY FILE 


commands are supported by the remote system. 7 Process puts and gets between SDDM file transfer 
and remote system's Release 5 TDDM mainline. 


2 Perform initialization for the load file and unload file 
requests and pass return code to caller. This 
includes loading put next loaded record or get next 
unloaded record into the caller's region. 


SDDM LIST FILE 
SERVER ATTRIBUTES 


(#RMXA) 


SDDM Load/ 7 
Unload Initialization 
(#RMXI) 


SDDM Put Next 
Unloaded Record 
(SRMXG) 


Caller via 
Transfer SVC 
Instruction 

or Program 
Loading into 
Caller’s Region 


SSP-ICF 
Data 
Management 


SDDM Get Next 
Unloaded Record 
(SRMXP) 


SDDM Terminate 
Load/Unload 
(A#RMXT) 


SDDM 
Copy File 
(ARMXC) 


Chart 4.11.8 Source DDM (SDDM) File Transfer Process Control Flow 


Release 5 
TDDM Mainline 


(Chart 4.11.11) 
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Source DDM (SDDM) Cleanup Processing 3. Do the following DDM termination cleanup: 


Before or during user program termination, other SSP » If end of job, release all DDM-acquired APPC 

programs invoke SDDM cleanup processing via SVC subsystem sessions. 

instructions accompanied by appropriate parameter lists. 

The following SDDM cleanup processes are shown in - If end of step, release any DDM-acquired 

Chart 4.11.9: APPC subsystem sessions not needed for next 
job step. 


1 Delete specified file and send equivalent command 


to TDDM under the following conditions: ¢ Dequeue and free any session RFSs not needed 


by next job step. 
e«  \f deallocate request and file is a RETAIN-S 


file, or if the deallocate requester specified « Dequeue and free any NELs that are no longer 
delete. needed by any job in the system. 
e If (normal) termination request and file is an old 4 Process for the following errors: 


file to be deleted. 


« Errors detected by SDDM modules. 
e If abnormal termination, delete all new files that 


were allocated. ¢ Abnormal SSP-ICF return codes. 
2 Unlock (RDEQ) remote file by sending DDM 5 Use SYSLOG to issue message to history file 
UNLOCK FILE command to TDDM. and/or user’s CRT or system console. 


SDDM Delete 
(Chart 4.11.7) 


Deallocate 


SDDM 
RENQ/RDEQ 
(Chart 4.11.3) 


Terminate Remote 
Files 
(4CTEDM) 


Release 3 and 
Release 4 
TDDM Mainline 


SSP-ICF Data 


Management 


(Chart 4.11.10 
or Chart 4.11.11) 


DDM Release 
(#RMSZ) 


SDDM Modules 
(Charts 4.11.1 
through 4.11.4) 


SDDM Communication 
Error Handler 
(#RMCE) 


SYSLOG 
(#CLSG) 


DDM Message 
Handler 
(#RMMH) 


Caller via Transfer 
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Chart 4.11.9 Source DDM (SDDM) Cleanup Processing Control Flow 
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Release 3 and Release 4 Target DDM (TDDM) 
Mainline 


The Release 3 and Release 4 target DDM (TDDM) 
mainline is evoked by the remote system’s source DDM 
(SDDM), to service file requests received from the 
remote system. Communications between the remote 
SDDM and the local Release 3 and Release 4 TDDM take 
place within an APPC subsystem session established by 
SDDM. Release 3 and Release 4 TDDM, simulating a 
local application program, makes the remote request 
appear as a local request to the SSP. 


The following Release 3 and Release 4 TDDM mainline 
processes are shown in Chart 4.11.10: 


1. Perform initial processing on all remote file access 
requests received from the remote system's SDDM. 
Route for appropriate processing of request and 
pass applicable completion status back to SDDM 
requester. 


2 Process DDM LIST FILE ATTRIBUTES command 
received from SDDM extract. 


3 Find specified file entry in VTOC or network 
resource directory (NRD) and pass results back to 
Release 3 and Release 4 TDDM extract. 


4 Process response from VTOC extract: 


e If requested file entry was found in VTOC, pass 
requested information back to Release 3 and 
Release 4 TDDM mainline in reply data element. 


e If requested file entry was not found in VTOC 
or NRD, return error reply code to Release 3 
and Release 4 TDDM mainline. 


5 Process DDM LOCK FILE or UNLOCK FILE command 
received from SDDM RENQ/RDEQ. 


6 Find specified file entry in VTOC or NRD and pass 


results back to Release 3 and Release 4 TDDM 
RENQ/RDEQ. 
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10 


11 


Process response from VTOC extract: 


e If requested file entry was found in VTOC, 
process DDM LOCK FILE or UNLOCK FILE 
command: 

— lf DDM LOCK FILE command, pass control 
to special allocate. 

— lf DDM UNLOCK FILE command, pass 
control to deallocate. 


¢ — If requested file entry was not found in VTOC 
or NRD, return error reply code to Release 3 


and Release 4 TDDM mainline. 


Perform file allocate portion of DDM LOCK FILE 
command: 


e Build and queue FSB and format 1. 
e Resource enqueue format 1 (lock file). 


e Return to Release 3 and Release 4 TDDM RENO 
(allocation will be done by open). 


Process DDM UNLOCK FILE command: 
e Dequeue and free FSB (unlock file). 
e Resource dequeue format 1. 


e Return to Release 3 and Release 4 TDDM 
RDEQ. 


Process to clear DDM CREATE or RECREATE 
PHYSICAL FILE command received from SDDM 
allocate: 


e Convert DDM command parameters to special 
allocate parameter list. 


e Call special allocate to clear create or recreate 
file. 


e Call deallocate to deallocate file (file will be 
reallocated by open). 


Find specified file entry in VTOC or NRD and pass 
results back to Release 3 and Release 4 TDDM 
allocate. 
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12 


13 


14 


15 


16 


17 


18 


Process response from VTOC extract: 


If create physical file was found in VTOC or in 
the remote system's VTOC, return an error 
reply code to the Release 3 and Release 4 
TDDM mainline. Otherwise, create the file. 


If recreate physical file was found in VTOC or in 
the remote system’s VTOC, recreate the file. 
Otherwise, return error reply code to Release 3 
and Release 4 TDDM mainline. 


Perform allocation processing requested, then 
deallocate file (in anticipation of open request). 


Process DDM OPEN FILE command passed by 
remote system’s SDDM: 


e Call special allocate with FSB. 


« Place format-1 information in DTF. 


e Convert DDM OPEN FILE command parameters 


into DTF parameters. 


e Call open. 


Find specified file entry in VTOC or NRD and pass 


results back to Release 3 and Release 4 TDDM 
open. 


Process response from VTOC extract: 
e If requested file entry was found in VTOC, 


process DDM OPEN command and route to 
open processor. 


e If requested file entry was not found in VTOC 


or NRD, return error reply code to Release 3 
and Release 4 TDDM mainline. 


e Set local or remote status of requested file for 
later use by #RDTM's disk data management's 


interface. 


Allocate specified file (pre-allocate processing was 


done at allocate time). 


Open specified file and return to Release 3 and 
Release 4 TDDM open. 


19 Process DDM record access commands received 


20 


21 


22 
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from remote system: 


If file status (set by Release 3 and Release 4 
TDDM open) is remote, pass command to 
Release 3 and Release 4 TDDM relay. 


If file status is local: 

— Convert DDM command to disk data 
management op code. 

— Convert DDM command parameters to disk 
DTF parameters. 

— l|ssue DTF to disk data management. 

— Convert disk data management completion 
code to DDM completion status. 

— Send any data records and status back to 
SDDM requester. 


Process DELETE FILE command received from 
SDDM file delete. 


Process RENAME FILE command received from 
SDDM file rename: 


Find specified file entry in VTOC or NRD and 
pass results back to Release 3 and Release 4 
TDDM file rename. 


Process response from VTOC extract: 

— If requested file entry was found in VTOC, 
process RENAME FILE command. 

— If requested file entry was not found in 
VTOC or NRD, return error reply code to 
Release 3 and Release 4 TDDM mainline. 


Rename specified file. 


Process BLDINDEX FILE command received from 
SDDM file build index: 


Find specified file entry in VTOC or NRD and 
pass results back to Release 3 and Release 4 
TDDM file rename. 


Process response from VTOC extract: 

— If requested file entry was found in VTOC, 
process BLDINDEX FILE command. 

— If requested file entry was not found in 
VTOC or NRD, return error reply code to 
Release 3 and Release 4 TDDM mainline. 
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e Special allocate physical file to perform security. 


e Deallocate physical file to release security. 
e Build index for specified file. 

23 Find specified file entry in VTOC or NRD and pass 
results back to Release 3 and Release 4 TDDM file 
delete. 


24 Process response from VTOC extract: 


e If requested file entry was found in VTOC, 
process DELETE FILE command. 


e If requested file entry was not found in VTOC 
or NRD, return error reply code to Release 3 


and Release 4 TDDM mainline. 


25 Delete specified file. 
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26 Process CLOSE FILE command received from SDDM 
file close: 


e If file status (set by Release 3 and Release 4 
TDDM open) is remote, pass request to Release 
3 and Release 4 TDDM relay. 


e If file status is local: 
— Convert DDM command to DTF op code. 
— Convert DDM command parameters to DTF 
parameters. 
— Issue DTF to close. 
— Convert close completion code to DDM 
completion status. 


27 Close specified file. 


28 Deallocate specified file. 
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Chart 4.11.10 (Part 1 of 2) Release 3 and Release 4 Target DDM (TDDM) Mainline Control Flow 
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Chart 4.11.10 (Part 2 of 2) Release 3 and Release 4 Target DDM (TDDM) Mainline Control Flow 
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Release 5 Target DDM (TDDM) Mainline 


The Release 5 target DDM (TDDM) mainline is evoked by 
the remote system's source DDM (SDDM), to service file 


requests received from the remote system. 
Communications between the remote SDDM and the 
local Release 5 TDDM take place within an APPC 
subsystem session established by SDDM. Release 5 


TDDM, simulating a local application program, makes the 


remote request appear as a local request to the SSP. 


The following Release 5 TDDM mainline processes are 
shown in Chart 4.11.11: 


1 


Perform initial processing on all remote file access 
requests received from the remote system’s SDDM. 
Route for appropriate processing of request and 
pass applicable completion status back to SDDM 
requester. 


Perform initialization for Release 5 TDDM mainline. 
Route control to TDDM exchange server attributes 
module. 


Process EXCHANGE SERVER ATTRIBUTES 
command received from SDDM. 


Process DDM LIST FILE ATTRIBUTES command 
received from SDDM extract. 


Find specified file entry in VTOC or network 
resource directory (NRD) and pass results back to 
Release 5 TDDM extract. 


Process response from VTOC extract: 


e _ |f requested file entry was found in VTOC, pass 
requested information back to Release 5 TDDM 
mainline in reply data element. 


e If requested file entry was not found in VTOC 
or NRD, return error reply code to Release 5 
TDDM mainline. 


Process DDM LOCK FILE or UNLOCK FILE command 
received from SDDM RENQ/RDEQ. 
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Perform file allocate portion of DDM LOCK FILE 
command: 


e Build and queue FSB and format 1. 
e Resource enqueue format 1 (lock file). 


e Return to Release 5 TDDM RENO (allocation will 
be done by open). 


Process DDM UNLOCK FILE command: 

e Dequeue and free FSB (unlock file). 

e Resource dequeue format 1. 

¢« Return to Release 5 TDDM RDEQ. 

Process to clear DDM CREATE or RECREATE 
PHYSICAL FILE command received from SDDM 


allocate: 


e Convert DDM command parameters to special 
allocate parameter list. 


e Call special allocate to clear create or recreate 
file. 


e Call deallocate to deallocate file (file will be 
reallocated by open). 


Perform allocation processing requested, then 
deallocate file (in anticipation of open request). 


Process DDM OPEN FILE command passed by 
remote system's SDDM: 


e Call special allocate with FSB. 
e Place format-1 information in DTF. 


e Convert DDM OPEN FILE command parameters 
into DTF parameters. 


e Call open. 
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13 


14 


15 


16 


17 


18 


19 


20 


21 


Allocate specified file (pre-allocate processing was 
done at allocate time). 


Open specified file and return to Release 5 TDDM 
open. 


Process DELETE FILE command received from 
SDDM file delete. 


Delete specified file. 


Process CLOSE FILE command received from SDDM 
file close: 


e If file status (set by Release 5 TDDM open) is 
remote, pass request to Release 5 TDDM relay. 


e If file status is local: 
~— Convert DDM command to DTF op code. 
— Convert DDM command parameters to DTF 
parameters. 
~— lssue DTF to close. 
~ Convert close completion code to DDM 
completion status. 


Deallocate specified file. 
Close specified file. 


Process input record operation requests received 
from SDDM get. 


Process DDM record access commands received 
from remote system: 


« Convert DDM command to disk data 
management op code. 


e Convert DDM command parameters to disk DTF 
parameters. 


e Issue DTF to disk data management. 


e Convert disk data management completion 
code to DDM completion status. 


e Send any data records and status back to 
SDDM requester. 
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22 


23 


24 


25 


26 


2] 


Process output record operation requests received 
from SDDM put. 


Process RENAME FILE command received from 
SDDM file rename. 


e Find specified file entry in VTOC or NRD and 
pass results back to Release 5 TDDM file 
rename. 


e Process response from VTOC extract: 
— If requested file entry was found in VTOC, 
process RENAME FILE command. 
— If requested file entry was not found in 
VTOC or NRD, return error reply code to 
Release 5 TDDM mainiine. 


e Rename specified file. 


Process BLDINDEX FILE command received from 
SDDM file build index. 


e Find specified file entry in VTOC or NRD and 
pass results back to Release 5 TDDM file 
rename. 

e Process response from VTOC extract: 

— If requested file entry was found in VTOC, 
process BLDINDEX FILE command. 

— If requested file entry was not found in 
VTOC or NRD, return error reply code to 
Release 5 TDDM mainline. 

e Special allocate physical file to perform security. 

¢ Deallocate physical file to release security. 


e Build index for specified file. 


Process UNLOAD FILE command received from 
SDDM. 


Process LOAD FILE command received from SDDM. 


Process COPY FILE command received from SDDM. 
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Chart 4.11.11 (Part 1 of 2) Release 5 Target DDM (TDDM) Mainline Control Flow 
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Chart 4.11.11 (Part 2 of 2) Release 5 Target DDM (TDDM) Mainline Control Flow 
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Release 3 and Release 4 Target DDM (TDDM) VTOC 
Extract 


The Release 3 and Release 4 target DDM (TDDM) VTOC 
extract is called by other Release 3 and Release 4 TDDM 
modules to find the requested file label. If the file label 
is not found in the target system's VTOC, Release 3 and 
Release 4 TDDM VTOC extract searches the network 
resource directory (NRD). If the file label is found in the 
NRD, the request is passed to Release 3 and Release 4 
TDDM relay for routing to the next Release 3 and 
Release 4 TDDM system. 


The following Release 3 and Release 4 TDDM VTOC 
extract processes are shown in Chart 4.11.12: 


1 


2 


Set remote files not allowed and call VTOC access. 


Find specified file entry by checking VTOC; pass 
return code back to caller. 


Process response from VTOC access: 


e — If requested file entry was found in VTOC, 
return format 1 to caller to continue processing 
requested by source DDM (SDDM) requester. 


e _ |f requested file entry was not found in VTOC, 
pass request to SDDM VTOC extract to search 
for the NRD entry. 


e  |f requested file entry was found in NRD, pass 
request to Release 3 and Release 4 TDDM relay 
for routing to appropriate system's Release 3 
and Release 4 TDDM. 


e _ If requested file entry was not found in VTOC 
or NRD, return file-not-found reply code to caller 
to be passed to Release 3 and Release 4 TDDM 
mainline for transmission to SDDM requester. 


VTOC Extract 
Subroutine 

(included in 

every Release 3 

and Release 4 TDDM 
calling module) 


Release 3 and 
Release 4 


TDDM Callers 
(Chart 4.11.6) 


4 If NRD entry found: 
e Lock entry. 
e Set up APPC subsystem session. 


If requested file entry was not found in NRD, return 
file-not-found reply code to caller. 


5 Relay request to system specified in NRD entry for 
requested file. 


6 Send request passed by Release 3 and Release 4 
TDDM relay to APPC subsystem for transmission to 
next Release 3 and Release 4 TDDM system. 


7 ~~ +Pass next target system's reply to caller. 


Relay reply received from other Release 3 and 
Release 4 TDDM back to the SDDM system. 


2 VTOC Access SDDM VTOC 


Gi Extract 
(Chart 4.11.1) 


Release 3 and 


Release 4 SSP-ICF Data 


Management 


TDDM Relay 
(#RDTT) 1.0 
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Chart 4.11.12 Release 3 and Release 4 Target DDM (TDDM) VTOC Extract Control Flow 
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DDM Trace (SDDM and TDDM) 


DDM trace processes a request from an SDDM or TDDM 
module to log a DDM data stream to an active trace file. 
This processing is performed only when trace is active 
for DDM. 


The following DDM trace processes are shown in Chart 
4.11.13: 


1 Call DDM communications trace to log data stream 
data to trace file. 


2 Perform the trace logging. 


DDM 
SDDM or Communications 
TDDM Trace 


Log SVC 


Module (#RMCT) Instruction 
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Chart 4.11.13 DDM Trace (SDDM and TDDM) Processing Control Flow 
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QUERY DATA MANAGEMENT 


Query data management (ODM) is called by the 
Query/36 program product for the following purposes: 


e Generate code for specified selection fields. 

e Build sort control fields. 

e Process expressions and record select criteria. 
e Process joins. 

« Execute user query requests. 


The calling modules call query data management via a 
transfer SVC instruction with a query user parameter 
list. Query data management generates code 
customized for the user’s request and Stores it in the 
query common area of the query data management task 
work space. During the execution phase, query data 
management drivers call the generated code as 
Subroutines. 


The following table shows the locations of key data 
areas involved in query data management during the 
generation phase: 

Address 

(in Hex) Contents 

0000 Query common - program variables, 

generated code, RRN buffer (if used) 
3800 Query code generator modules 


C800 Query open (HDQQOP) 
E800 Query parameter list DTF 


Dump 
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The following table shows the locations of key data 
areas involved in QDM during the execution phase: 


Dump 

Address 

(in Hex) Contents 

0000 Query common - program variables, 
generated code, RRN buffer (if used), and 
|/O buffers 

D800 User output buffer (4K or 6K) 

FOOO Query driver modules 


Chart 4.12.1 shows an overview of query generation and 
execution functions: 


1 Perform initial processing based on user parameter 
list: 


¢ Map generator list. 
¢ Map to query common. 


¢ Dissect the query parameter list and build a 
new parameter list for each input file. 


¢ Route control to query code generators for each 
dissected parameter list built. 


2 Use initialized information and dissected parameter 
list passed by query open to generate code to 
execute user request. 

3 Onreturn from code generators, do the following: 


¢ Call query index optimizer (HDOXOP), if used. 


e Initialize control path, based on user request. 
Specify driver in parameter list. 


e Pass control to applicable sort driver or return to 
caller. 
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Use task work space (TWS) perform the following: 


If joining files, call query driver to fill work area 
buffer with records selected from previously 
processed input file(s). 


Fill work area input buffer with records from 
input file. 


If required, build scratch file for sort/merge. 
Branch to generated code to compare each 
record in work area buffer for record select 


criteria and join records (if joining files). 


Call query sort (7DQQS) to sort work area 
output buffer. 


Write sorted work area buffer to scratch file. 


Sort records in work area output buffer passed with 
request when sort complete, add end-of-buffer mark. 


Use TWS to perform the following: 


If joining files, call query driver to fill work area 
buffer with records selected from previously 
processed input file(s). 


Use relative record number (RRN) buffer to 
select records from input file and fill work area 
input buffer. 

If required, build scratch file for sort/merge. 
Branch to generated code to compare each 
record in work area buffer for record select 


criteria and join records (if joining files). 


Call query sort (#DQQS) to sort work area 
output buffer. 


Write sorted work area buffer to scratch file. 


If more than four sorted buffers are written to 
scratch file, use TWS to perform the following: 


Merge sorted buffers until number of buffers is 
four or less. 


Return control to caller with parameters set to 
call merge phase 2 (#DQM2). 
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10 


Use TWS to perform the following: 


¢ — If joining files, call query driver to fill work area 
buffer with records selected from previously 
processed input file(s). 


¢ Fill work area input buffer with records from 
input file. 


e Branch to generated code to compare each 
record in work area buffer for record select 
criteria and join records (if joining files). 


¢ Recursive calls between driver and caller (could 
be another driver if joining files) for each filled 
output buffer, until end-of-file. 


Use TWS to perform the following: 


e — If joining files, call query driver to fill work area 
buffer with records selected from previously 
processed input file(s). 


e Use RRN buffer to select records from input file 
and fill work area input buffer. 


¢ Branch to generated code to compare each 
record in work area buffer for record select 
criteria and join records (if joining files). 


¢ Recursive calls between driver and caller (could 
be another driver if joining files) for each filled 
output buffer, until end-of-file. 


Use TWS to perform the following: 
e If joining files, call query driver to fill work area 
buffer with records selected from previously 


processed input file(s). 


¢ Fill work area input buffer with records from 
input file. 


e Branch to generated code to compare each 
record in work area buffer for record select 
criteria and join records (if joining files). 

e Using file specification block (FSB) pointed to by 
the query parameter list, write buffer(s) of 


selected records to caller specified file. 


¢ Onend of input file, return control to caller. 
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11 Use TWS to perform the following: 


¢ Merge sorted buffer(s) in scratch file until end of 
data is reached. 


e Write selected records from scratch file into 
user's output buffer. 


« Recursive calls between merge driver and caller 
until end of data is reached. 
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List Driver 
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Driver 
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User Driver 


(#D0Q1DU/#DQ1JU) Index Scan to 
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Chart 4.12.1 Query Data Management (QDM) Control Flow 
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Job Termination Function 


The job termination function contains all SSP 
programming required for end-of-step, end-of-job, or 
abnormal termination processing. It includes the 
following subfunctions: 


« Close Chart 5.1.1 


e Termination Chart 5.2.0 


CLOSE SUBFUNCTION 
The close subfunction ensures that files used by a step 
or job are properly closed prior to step or job 


termination by: 


e Completing the processing of any data in output 
buffers 


e Freeing SQS data areas that were obtained when 
the file was opened 


e Restoring all opened DTFs to a preopened status 


Close also provides for the reallocation and reopening of 


disk files. 


The close subfunction is performed by a common close 
transient and the necessary device-oriented close 
transients. Close is invoked by the transfer SVC 
instruction with XR2 pointing to the postopen DTF 
chain. The transfer SVC instruction causes the loading 
and execution of the common open transient, which 
loads and executes the necessary device-oriented close 
transients. Each device-oriented module searches the 
DTF chain to ensure that it has restored all applicable 
DTFs of its device type to preopen status before it 
terminates. 


The following DTF close processes are shown in Chart 
-o Pad He 


1 Perform common close processing: 
e Examine DTFs on backward DTF chain. 


e If there are printer DTFs to be closed: 

— Complete processing of print buffer data. 

— Free assign/free space used for printer |OB 
and buffer (includes remote print buffer, if 
any). 

— Restore DTF to preopened status. 


« If there are work station DTFs to be closed, 
alter the DTF attribute bytes to restore the 
DTFs to preopened status. 


e lf there are BSC DTFs to be closed, set up DTF 
and communications specification block (CSB) 
and transfer to the BSC task. 


« If there are other device DTFs, call appropriate 


device-dependent close transient (call disk 
close last). 
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2 ~=Find all diskette DTFs on the chain to be closed and 4 
close them: 


Find all disk DTFs on the chain to be closed and 
close them: 


« Update active format-1 image and call 
end-of-volume processing if required. 


Note: If disk close is called by termination or 
abnormal termination, FSBs are used to close disk 
files. 

¢ If required, write data set label to VTOC. 

¢ Complete the processing of data in the output 


If an output error caused end of volume, issue 
error message and perform end-of-volume 
processing. 


Restore DTF to preopened status. 


buffers. 
Free SQS control blocks obtained by disk open. 


If sectorized data management access method 


(ZPAM) DTF, free the IOB (in SQS) that was 
obtained by disk open; if ZPAM output or add 
access method, update main storage data set 
label. 


3. Find all tape DTFs on the chain to be closed and 
close them: 


e If put or add with fixed block, write remaining 


records in physical buffer and trailer labels to e If request is for a remote file, perform 
tape. distributed data management file close. 
e Process appropriate end condition: rewind, e Restore DTF to preopened status. 


unload, or leave. 
5 Perform diskette end-of-volume processing. 
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Chart 5.1.1 Close Control Flow 
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TERMINATION SUBFUNCTION The following termination overview processes are shown 


in Chart 5.2.0: 
Note: Initial termination processing is performed by 
control storage nucleus task termination. This topic 1 Perform initial termination processing: 
describes only termination processing performed in main 
storage. e If task has no JCB, route control to task 
detach. 
The termination subfunction performs cleanup activity 
required to start a new job step or end the current job. ¢ If task has a JCB, route control to termination 
Termination is called via the termination interface mainline for further processing. 


transient. It can be called in one of four ways: 


2 Detach task. 
e At step or job termination, the calling program 


invokes the termination interface transient via the 3 Perform mainline processing, routing control where 
transfer SVC instruction with an RIB. necessary. 

e On an inquiry 2 or 3 option, or the CANCEL 4 Process for JCB termination, routing control where 
command, the command processor calls the necessary. 


termination interface transient. 


5 At end-of-task cleanup, detach task. 
e On an option 3 in response to a SYSLOG halt, 


SYSLOG calls the termination interface transient. 6 At end of step, start next job step. 


e On abnormal termination with a dump request, the 
control storage end-of-job transient ($EJ1) calls the 
termination interface transient. 
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Chart 5.2.0 Termination Overview Control Flow 
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Termination Interface 


The following termination interface processes are shown 
in Chart 5.2.1: 


1 Perform initial termination interface processing: 


e If task has no JCB: 

— Route control to console cleanup to handle 
outstanding console messages. 

— Route control to error message handler to 
clean up outstanding error messages. 

— Route control to system measurement 
facility (SMF) to clean up SMF control 
blocks. 

— Route control to task detach. 


e« If task has a JCB, perform other interface 
mainline processing, routing control where 
necessary. 


2 Resolve cross-references between library modules. 


3 Issue any required messages for control storage 
termination processing. 


4  |f applicable, perform cleanup processing on folder 
management services (FMS) files. 


5 Close any remaining disk files. 
6 Close any remaining files. 


7 ‘If applicable, perform cleanup on communications 
specifications block. 
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Chart 5.2.1 Termination Interface Control Flow 
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Termination Mainline 


The following termination mainline processes are shown 
in Chart 5.2.2: 


Perform termination mainline functions; and if 
necessary, keysort any disk for the following 
processes. 


2 Perform cleanup on any outstanding console 
messages. 

3 If applicable, perform cleanup processing on 
distributed data management (DDM) files, routing 
control for remote file delete, resource dequeue, and 
release (to release the session to the remote 
system). 

4 Release remote files. 

5 Perform cleanup on local files, routing control to disk 
VTOC access and SMF where applicable. 

6 Perform any required processing of alternative 
indexed and text management services files, routing 
control to disk VTOC access and SMF where 
applicable. 

7 Perform cleanup on procedure parameter save area 
(PPSA). 

8 Perform any required library cleanup. 

9 Perform cleanup for any outstanding error 
messages. 

10 Perform cleanup on any associated spool files. 

11 Perform any required cleanup on diskette file. 
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Termination Interface 
(Chart 5.2.1) 


DDM Delete 


Console Cleanup 


DDM Resource 
Dequeue 


DDM File Cleanup 
(#CTEDM) 


DDM Release 


File Support Disk VTOC 
(ACTEFP) Access 


Termination 
Mainline 
(HCTEML) 


MI/TMS Termination 
Support 
(#CTEVI) 


7 PPSA Access 


Library Free 
| 8 8 Error Message 
8 | Cleanup 


Print Spooling 
Diskette VTOC 
A Read/Write 


Termination 


4 JCB Support 
(Chart 5.2.3) 
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Chart 5.2.2 Termination Mainline Control Flow 
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Termination JCB Support 


The following termination JCB support processes are 
shown in Chart 5.2.3: 


1 Perform mainline functions for the following JCB 
termination processes. 


2 Issue any required halts, messages, and return 
codes. 


3 Issue end-of-SYSLIST-data message. 


4 If applicable, clean up any outstanding session unit 
blocks (SUBs). 


5 Process for display station command rejects. 


6 Release display stations associated with terminating 
task. 


7 ‘If required, compress disk. 
8 Start the next job step. 
9 Time stamp the job in the history file. 


10 Perform system measurement facility cleanup. 
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System Services Function @ 


The system services function consists of all SSP 


librarian facilities and miscellaneous services functions. 
It contains the following subfunctions: 


e Librarian facilities 


Find a library 

Single name find 
Librarian find 

Source library get 
Library record put 
Library sector get/put 
Library member delete 
Library member protect 
Library member change 
Library access method 
Library reallocate 


e Miscellaneous services functions 
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Active format-1 area 
access 

Cross-reference resolver 
Build membership table 
Disk VTOC access 
Diskette VTOC read/write 
Message retrieve 

SYSIN 

SYSLIST 

SYSLOG 

History file put 

Supervisor task attach 
Supervisor task detach/ 
change origin point 
Syntax checker 
Information retrieval 

Snap dump 

Diskette data save/restore 
Diskette magazine drive 
search 


Chart 6.1.0 
Chart 6.1.1 
Chart 6.1.2 
Chart 6.1.3 
Chart 6.1.4 
Chart 6.1.5 
Chart 6.1.6 
Chart 6.1.7 
Chart 6.1.8 
Chart 6.1.9 
Chart 6.1.10 
Chart 6.1.11 


Chart 6.2.1 


Chart 6.2.2 
Chart 6.2.3 
Chart 6.2.4 
Chart 6.2.5 
Chart 6.2.6 
Chart 6.2.7 
Chart 6.2.8 
Chart 6.2.9 
Chart 6.2.10 
Chart 6.2.11 
Chart 6.2.12 


Chart 6.2.13 
Chart 6.2.14 
Chart 6.2.15 
Chart 6.2.16 
Chart 6.2.17 


LIBRARIAN FACILITIES 


The librarian facilities subfunction provides the user with 
accessability to members contained in the system library 
or in user libraries. The librarian routines are mainly 
used by SSP programming or by compiler-built 
programming, but they can also be invoked by the user. 
The librarian facilities subfunction consists of the 
following: 


Find a library routine locates a requested library. 


Single name find routine locates a library member in 
either the system library or the specified user library 
and optionally returns a loader parameter list. 


Librarian find routine locates library directory entries 
by type and full or partial name. 


Source library get routine gets records from either 
source or procedure members. 


Library record put routine places source or 
procedure records into a library. 


Library sector get/put routine gets members in 
sector mode from a library and puts members into a 
library in sector mode. 


Library member delete routine deletes a library 
member from a specified library. 


Library member protect routine prevents the 
simultaneous use of a library member by more than 
one task. 


Library member change routine changes a library 
member's name, subtype, and/or reference number. 


Library access method routine provides a single 
interface to many commonly-used librarian facilities: 
— Find a library 

— Member find 

— Member delete 

— Member rename 

— Member protection 

— Member get 

— Member put 

— Member copy 


Library reallocate routine reallocates a specified 
library that allows members located in an extent to 
be placed in the library. 
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Chart 6.1.0 shows the overview control flow for the 
librarian facilities subfunction: 


Find a Library 
Routine 


(AMAFLB) 
(Chart 6.1.1) 


Single Name 
Find Routine 
(H#MASFN) 

(Chart 6.1.2) 


Librarian Find 
Routine 

(SMAFND or $MALFN) 
(Chart 6.1.3) 


Source Library 

Get Routine 

(ZMASGT or #MASYL) 
Library Record (Chart 6.1.4) 

Put Routine 
(SMAPUR or #MAPR) 
(Chart 6.1.5) 


Calling Program 
via Transfer or 
Load SVC 
Instruction 

with XR2 


Library Sector 

Get/Put Routine 
(A4MAPGS or #MASEC) 
Library Member (Chart 6.1.6) 

Delete Routine 


(#MADT) : 
(Chart 6.1.7) Library Member 


Protect 
(2MAMPM) 
(Chart 6.1.8) 


m= Parameter 
List 


Library Member 
Change 


MACG 
ceo 6 9) Library Access 


Method 
(SMALAM) 
(Chart 6.1.10) 


Library Reallocate 


(#MARLA) 
(Chart 6.1.11) 
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Chart 6.1.0 Librarian Facilities Overview Control Flow 
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Find a Library Routine 


The find a library routine returns the address of the 
requested library format 1, when given an 8-byte library 
name. lf the library cannot be located or is flagged as 
invalid, the routine returns an address of O's. This 
routine is used when access is needed to members in 
libraries other than the designated user library. The 
format-1 address of a library is used by other librarian 
access routines. 


The following find a library processes are shown in 
Chart 6.1.1: 


1 Do the following: 


« If requested library is #LIBRARY, get format-1 
address from SCA. 


e Find or build requested library format 1 in active 
format-1 area (AFA). 


« Chain requested library format 1 to caller's JCB 
with a file specification block (FSB). 


2 If security is active and the requested library is 
resource-protected, verify requester’s authorization. 


Resource Security 


Calling Program Check 1 


via Transfer SVC Find a Library 8 


Routine 
(#MAFLB) 


Instruction with 
Library Parameter 


Disk VTOC 
List 


Access 
(Chart 6.2.4) 


$0590294-0 
Chart 6.1.1 Find a Library Routine Control Flow 
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Single Name Find Routine 


The single name find routine finds a specified library 
member by searching first in the user library if there is 
one, then in the system library. Unless otherwise 
requested, the user can override the designated user 
library and specify any user library. The user can specify 
to search only the system library or only the user library. 
Single name find returns 17 bytes of loader information 
and a portion of the directory entry or a transfer 
parameter list and indicates if the member was found in 
the user library or the system library. 


The following single name find processes are shown in 
Chart 6.1.2: 


1 Enqueue library for duration of search. 

2 Search user library directory if specified. 

3 If necessary, search system library directory. 
4 Process returned altered parameter list. 


5 If requested member not found, process returned 
unaltered parameter list. 


6 If requested member not found and build loader 
parameter list was specified, display name of 
member not found, and issue message. 


Control Storage 


Calling Program | 
via Transfer SVC Single Name 
Instruction with Find Routine 


Library Parameter (#AMASFN) 


List SYSLOG 
(Chart 6.2.9) 


S0590295-0 
Chart 6.1.2 Single Name Find Routine Control Flow 
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Librarian Find Routine 


The librarian find routine locates directory entries by 
type and full or partial name. The caller provides a 
buffer, specifies the library to search, gives the member 
types, and gives the member name or partial name and 
length. The librarian find routine returns the address of 
the member in the buffer of the next directory entry 
meeting the criteria or indicates that no more members 
meet the specified criteria. 


Note: This routine exists in both a transient version 
(SMAFND) and a loadable version (SMALFN). Calling 
programs invoke $MAFND via the transfer SVC 
instruction or SMALFN via the load SVC instruction. 
Their functions are identical except that the transient 
version needs a 25-byte work area following the 
parameter list, and the partial name find is not 
supported. 


The following librarian find processes are shown in 
Chart 6.1.3: 


1 Determine library to search. 


2  Enqueue library directory and scan for request; read 
directory into user's buffer. 


3 Search for match on type and name. 
4 Update parameter list for result of search. 


5 Perform cleanup. 


Control Storage 


Calling Program via 
Transfer or Load Librarian Find 
SVC Instruction Routine 


with XR2 => (SMAFND or $MALFN) 
Parameter List SYSLOG 


(Chart 6.2.9) 


$0590296-0 
Chart 6.1.3 Librarian Find Routine Control Flow 
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Source Library Get Routine 


The source library get routine finds either a source or 
procedure member, and moves the records, one at a 
time, from the member into the user's record buffer. 
When it transfers the records, any deleted blanks are 
padded back into the record. 


Note: This routine exists in both a transient version 
(#4#MASGT) and an include version (HMASYL). Using 
programs invoke #MASGT via the transfer SVC 
instruction and #MASYL via the load SVC instruction or 
a branch instruction with XR1 pointing to a 70-byte work 
area. Their functions are identical except that the 
transient version requires a 16-byte work area following 
the parameter list, and the include version does not 
perform the find function. 


The source library get processes are shown in Chart 
6.1.4: 


1 ‘If find request, find the member (#MASYL). 
2 (|f first request, read library member. 


3 Expand blanks into record and place in user record 
buffer. 


4 Update the parameter list. 


5 If last record, set EOF indicator. 


Single Name Find 
(Chart 6.1.2) 


Calling Program via 
Transfer or Load 
SVC Instruction, or 


Source Library Control Storage 


Get Routine Disk |OS 


Branch Instruction (#MASGT or #MASYL) 
each with XR2 a> 


Parameter List 


SYSLOG 
(Chart 6.2.9) 


$0590297-0 
Chart 6.1.4 Source Library Get Routine Control Flow 
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Library Record Put Routine 


The library record put routine places records into a 
source or procedure library member. The routine 
compresses contiguous blanks using a hexadecimal 
counter in place of the blanks. Normal character strings 
are moved into the member intact, but are prefixed with 
a count byte. 


Note: This routine exists in both a transient version 
(#MAPR) and a loadable version (SMAPUR). Calling 
programs invoke #MAPR via the transfer SVC instruction 
or $MAPUR via the load SVC instruction. Their 
functions are identical. 


The following library record put processes are shown in 
Chart 6.1.5: 


1 If open request, open the library. 


2 Put source or procedure records, in compressed 
format, into the buffer. 


3 Write the buffer to the library and update the 
number of available sectors in the LCS. 


4 If close request, close the library. 


5 Return to caller. 


Library 
Open/Close 


Calling Program via Routine 
Transfer or Load Librarian Record (SMALCO or $MACOM) 


SVC Instruction Put Routine 


with XR2 => (SMAPUR or #MAPR) 
Parameter List 


Control Storage 


$0590298-0 
Chart 6.1.5 Library Record Put Routine Control Flow 
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Library Sector Get/Put Routine 


The library sector get/put routine can get members, in 
sector mode, from a library and pass them via a buffer to 
the requester or put members into a library via a caller- 
supplied buffer. It also handles library open requests 
and performs a forced close of the library if a get or put 
is done on a complete library member. 


Note: This routine exists in both a transient version 
(#MASEC) and a loadable version (SMAPGS). Calling 
programs invoke #MASEC via the transfer SVC 
instruction or $MAPGS via the load SVC instruction. 
Their functions are identical. 


The library sector get/put processes are shown in Chart 
6.1.6: 


1 ‘If find/get request, find the member. 
2 If get request, retrieve member from the library. 


3 If get request and there are PTFs applied, get PTF 
information. 


4 If put request, open the library. 
5 Put the member into the library. 


6 Close the library if necessary. 


Single Name Find 
(Chart 6.1.2) 


25 Control Storage 


Calling Program via Library Sector laa 
Transfer or Load Put/Get Routine 


SVC Instruction (SMAPGS or #HMASEC) 
with XR2 => 


Parameter List 


PTF Handler 
(SMAPTF) 


4,6| Library Open/Close 
Routine 
(SMALCO or $MACOM) 
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Chart 6.1.6 Library Sector Get/Put Routine Control Flow 
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Library Member Delete Routine 


The library member delete routine deletes 
non-IBM-supplied members by name and specified 
library. It performs the delete by setting the total 
number of sectors field to 0, then compacting the 
directory. The library member delete routine is invoked 
via a transfer SVC instruction with a delete parameter 
list that specifies the member name, the library member 
type, and the format-1 address of the library. 


The following library member delete processes are 
shown in Chart 6.1.7: 


1 Find the specified member. 


3 Update the member directory entry(s) to show zero 
total sectors. 


4 Write the directory back. 


5 Set switch in library control sector (LCS) to compact 
directory. 


Note: The compactor is shown here to illustrate the 
entire member delete process; control flows to the 
compactor only as a result of the LCS switch that 
was set by #MADT. 


Librarian Find 
Routine 
(Chart 6.1.3) 


Calling Program via 
Transfer SVC Library Member 


Control Storage 


Instruction with Delete Routine 
XR2 => (#MADT) 
Parameter List 


Compactor 
(SMACMP) 
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Chart 6.1.7 Library Member Delete Routine Control Flow 
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Library Member Protect Routine 


The library member protect routine can build a new 
member chain element and add it to the chain, or it can 
release an element from the chain. The library member 
protect routine is invoked via a transfer SVC instruction 
with a member protect parameter list that includes 
member type, member name, library format-1 address, 
and an operation byte. 


The following library member protect processes are 
shown in Chart 6.1.8: 


1 Search the member protect chain for a matching 
element. 


2  \f match not found and protect was requested, add 
the member to the chain. 


3 If match found and release was requested, release 
the member from the chain. 


Control Storage 


Calling Program via . 
Transfer SVC Library Member 


Instruction with Protect Routine 


XR2 > (AMAMPM) 
Parameter List 


$0590301-0 
Chart 6.1.8 Library Member Protect Routine Control Flow 
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Library Member Change Routine 


The library member change routine can be used to 
change the name, subtype, and/or reference number of 
a library member. The library member change routine is 
invoked via a transfer SVC instruction with a member 
change parameter list that includes the library format-1 
address, the member type, the member name, the 
member new name, the member subtype, the member 
reference number, and an operation byte. 


The following library member change processes are 
shown in Chart 6.1.9: 


1. ‘If change of name is not requested, find member(s) 
to be changed. 


2 Ensure this library member is not owned by another 
task. 


3 If requested, change the name, subtype and/or 
reference number in the directory entry buffer. 
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Write the updated directory entry back to disk. 


If a change of name was requested, make any 
previously-deleted directory entries available. 


Find member to be changed. 
Ensure this member is not owned by another task. 


Write the directory entry back to disk (the entry was 
previously marked as a deleted entry). 


Write the updated directory entry from the buffer to 
disk. 
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Librarian 
Find Routine 
(Chart 6.1.3) 


Library Member 
Protect 
(Chart 6.1.8) 


Calling Program via 
Transfer SVC 
Instruction with 


Library Member 
Change Routine 
(#MACG) 


Compactor 
(SMACMP) 


Parameter List 


Library Directory 


Insert 
(SMAILD) 
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Chart 6.1.9 Library Member Change Routine Control Flow 
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Library Access Method Routine The following library access method processes are 


shown in Chart 6.1.10: 
The library access method routine provides one user 


interface to the following librarian facilities: 1 Find the library. 


¢ Find a library 2 If operation is member find, member get, or 
member copy, find the member. 
e Member find 


3 If operation is delete, delete the member. 
« Member delete 


4 If operation is rename, change the member name. 
e Member rename 


5 If operation is protect, get, or copy, protect the 
e Member protect member. 


¢ Member get (by records/sectors) 6 If operation is get on source or procedure member, 
do source get. 
e Member put (by records/sectors) 
7 ‘If operation is get on load or subroutine member, 
e Member copy do sector get. 


¢ Directory list 8 If operation is put on source or procedure member, 


do record put. 
e Library reallocate 


9 __siIf operation is put on load or subroutine member, 


With one call to the library access method routine, the do sector put. 

requester can invoke combinations of the functions 

provided by these facilities. The library access method 10 If operation is copy, do sector get, then sector put. 
routine is invoked via a transfer SVC instruction with a 

library access parameter list. The parameter list includes 11. If operation is directory list, call 105 to scan and 

an operation byte, library name, member type, member read the directory. 


name, and new member name. 


12 If operation is library reallocate, reallocate the 
library. 
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Calling Program via 
Trasfer SVC 
Instruction with 
Parameter List 


Librarian Find 
Routine 
(Chart 6.1.3) 


Single Name 
Find Routine 
(Chart 6.1.2) 


Library Member 
Delete Routine 
(Chart 6.1.7) 


Library Member 
Change Routine 
(Chart 6.1.9) 


Library Member 
Protect Routine 
(Chart 6.1.8) Source Library 
Get Routine 


(Chart 6.1.4) 


Library Access 
Method Routine 


(#MALAM) 


7,9,10 Library Sector 
Get/Put Routine 


(Chart 6.1.6) Library Record 


Put Routine 
(Chart 6.1.5) 


Control Storage 


Library Reallocate 
Routine 
(Chart 6.1.11) 
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Chart 6.1.10 Library Access Method Routine Control Flow 
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Library Reallocate Routine 4 Copy the directory, the members and, if it exists, the 


file extent to the allocated disk space. 
The library reallocate routine reallocates a specified 


library to allow members located in an extent to be 5 Update the LCS. 

placed in the library. The user can specify new library 

and directory sizes for the library to be reallocated, even 6 ‘Fill any unused directory sectors with hex FF. 

if an extent does not exist. The library reallocate routine 

is-evoked by the ALOCLIBR procedure command via 7 Update the directory for any members moved from 
library maintenance mainline. the file extent. 

The following reader to library copy processes are shown 8 Update the library format 1 and the extent format 1 
in Chart 6.1.11: and write them back to the VTOC. 

1 Resource enqueue the library. 9 Zero the old library and its extent. 

2 Read the library control sector (LCS). 10 Deallocate the old library and its extent. 

3 Allocate disk space to move the library. 11 Return to mainline. 


Calling Program 
via Transfer SVC 


Instruction with 
XR2 =m Parameter List 


Control Storage 


Allocate 


Library Reallocate 


Disk 1OS 
(HMARLA) 


Disk VTOC Access 


11 10 Deallocate 


a oe 


$0590469-0 
Chart 6.1.11 Library Reallocate Routine Control Flow 


2-188 


This document contains restricted materials of IBM. LY21-0590-4 
©Copyright IBM Corp. 1983, 1984, 1985, 1986 


This page is intentionally left blank. 


Section 2: System Services Function 6 | 2-189 
This document contains restricted materials of IBM. LY21-0590-4 
©Copyright IBM Corp. 1983, 1984, 1985, 1986 


MISCELLANEOUS SERVICE FUNCTIONS Active Format-1 Area Access 


The miscellaneous service functions are for the most The active format-1 area access routine processes 
part, subroutine-type functions provided by SSP to requests for gets and puts of format-1 blocks to the 
privileged and nonprivileged users. Except where active format-1 area (AFA). The user can submit the 
otherwise noted, privileged and nonprivileged users following requests via the AFA access parameter list: 
invoke their supervisory functions via transfer SVC 
instructions accompanied by RIBs. e Get by label 
This function includes the following utilities: « Get by name (optionally returns file specification 
block (FSB) and its address) 
e Active format-1 area Chart 6.2.1 
access e Get by address 
e Cross-reference resolver Chart 6.2.2 « Put by address 
e Build membership table Chart 6.2.3 Active format-1 area access processes are listed below: 
« Disk VTOC access Chart 6.2.4 « Determine the function requested: 
— lf get by label for disk file, find format 1 in AFA 
¢ Diskette VTOC read/write Chart 6.2.5 chain and move it to caller's |/O area. 
— If get by label for diskette file, scan file 
e Message retrieve Chart 6.2.6 specification block (FSB) chain pointed to by 
JCB; if format 1 contains the correct unit, label, 
e SYSIN Chart 6.2.7 and (optional) date and ID, place format-1 
address in caller's parameter list and move 
« SYSLIST Chart 6.2.8 format 1 to the caller's |/O area. 
— If get by name, search the FSB chain for format 
« SYSLOG Chart 6.2.9 1; if format 1 contains the correct unit, place 
the format-1 address in the caller's parameter 
¢ History file put Chart 6.2.10 list and move the format 1 to the caller's |/O 
area. 
e Supervisor task attach Chart 6.2.11 — If get by address, move format 1 at specified 
address to the caller's |/O area. 
¢ Supervisor task detach Chart 6.2.12 — If put, move format 1 in caller's |/O area to the 
AFA specified in the parameter list. 
e Syntax checker Chart 6.2.13 — Update the parameter list return code and 
return to caller. 
e Information retrieval Chart 6.2.14 
e Snap dump Chart 6.2.15 
e Diskette data save/restore Chart 6.2.16 
e Diskette magazine drive Chart 6.2.17 
search 
2-190 


This document contains restricted materials of IBM. LY21-0590-4 
©Copyright IBM Corp. 1983, 1984, 1985, 1986 


Calling Program 
via Transfer SVC Active Format-1 


Instruction with Access Routine 
RIB and AFA (#CSAF) 
Parameter List 


$0590302-01 
Chart 6.2.1 Active Format-1 Area Access Control Flow 
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Cross-Reference Resolver e Read 6 sectors of the WTG table for each 
module with a WTG or FIT using the library 


The cross-reference resolver modifies where-to-go table. 

(WTG) tables that are referred to by privileged IBM 

modules when they call another module. The WTG ¢ For each module with a WTG table and/or a 

tables allow a calling module to omit the process of FIT, either search the library table for a 

calling the system find routine, before calling the matching entry (WTG processing) or use the FIT 

required module. The cross-reference resolver is run displacement to get information from the main 

any time IBM load members in the system library are storage format index for the index table being 

moved. This may be after an IBM load, library updated (FIT processing). 

condense, member delete, IPL, or an IBM load member 

copy to the library. ¢ If an entry is not found in the library table 
(WTG) or the format is not found (FIT), insert 

In addition to modifying the WTG tables, the the no-op screen and issue an error. 

cross-reference resolver also fills in display format index 

tables in IBM modules and updates the transfer table in ¢ Write the updated 6 sectors of the applicable 

main storage. modules back to their original locations on disk. 

The following cross-reference resolver processes are 2 Get library format 1's. 


shown in Chart 6.2.2: 
3 Read WTG table sectors as required. 
1 Do the following, routing control where necessary: 
4 Issue no-op errors as required. 
e Read library format 1's. 
5 Issue messages as required. 
¢« Build a library table of all IBM load modules 
including characters 2 through 5 of the name, 6 Write updated WTG table sectors back to their 
the disk address, the number of text sectors, original locations. 
the module attributes, the RLD displacement, 
and WTG and format index table (FIT) 
indicators. 


¢« Build a main storage format index table (FIT) 


from the index sectors of the command 
processor screen format modules. 
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Calling Program 
via Transfer 


SVC Instruction 
with RIB 


Disk VTOC 


Control Storage 


Access 
(Chart 6.2.4) 


Cross-Reference 
Resolver 
(#MAXRF) 


No-Op Routine Disk |OS 


(#MANOP) 


SYSLOG 
(Chart 6.2.9) 
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Chart 6.2.2 Cross-Reference Resolver Control Flow 
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Build Membership Table 


The build membership table transient passes a table 
containing the printable characters on a particular printer 
to the caller. It is invoked via a transfer SVC instruction 
by the following: 


e The command processor when it builds a STATUS 
SESSION display. 


¢ $MAINT when printing a load member. 
¢ $COPY when printing the contents of a file. 
Build membership table processes are listed below: 


e Determine the type of printer and its 
image/character set: 

— If called by command processor, point to work 
station WSWA and read printer specification 
table. 

— Find TUB; if TUB is not found and remote work 
stations are active, process remote work station 
printer. 

— If printer is not a 3262, process image for 
nonimage printer. 

— Read printer specification table (PST). 

— If the PST indicates the image is inline, process 
it. 


e Process image source member. 


° Return to caller. 


Build Membership Table 
#CSBT) 


r 


Calling Program 


via Transter Build Membership 


Table from Source 
Member 
(#CSBM) 


SVC Instruction 
Parameter List 
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Chart 6.2.3 Build Membership Table Control Flow 
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Disk VTOC Access e Process format-1 write request: 
— Build IOB for disk IOS to read sector specified 


The disk VTOC access routine performs three main in parameter list. 

functions: — Move format 1 from caller |/O area into sector 
just read and direct disk IOS to write sector 

e Format-1 read back to disk. 


— Return to caller. 
e Format-1 write 


e Process format-1 existence test: 


e Existence test — Set date indicator if requested and direct disk 
IOS to scan. 
Disk VTOC access is called via a transfer SVC — If format 1 found, update the parameter list 
instruction with XR2 pointing to a parameter list. return code and return to caller. 
— If format 1 not found and if caller allows 
Disk VTOC access processes are listed below: remote file access, call distributed data 
management (DDM) extract to search network 
¢ Determine the function requested. resources directory (NRD). 


e Process format-1 read request: 
— Scan VTOC for requested format 1. 
— If found, put format-1 sector displacement in 
parameter list and move format 1 to caller's |/O 


area. 

— If not found and if caller allows remote file 
access, call distributed data management 
(DDM) extract to search network resources 
directory (NRD). 


Calling Program Control Storage 
viaTransferSVC [| | ...}»}»}»  }©=©—)0—)6hD00U UD) pe eer 
Instruction with 
Parameter List 


Disk VTOC 
Access Routine 
(4CSVF) 


Source Distributed 
Data Management 
Extract 
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Chart 6.2.4 Disk VTOC Access Control Flow 
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Diskette VTOC Read/Write e Process format-1 read or existence test: 
— Read format 1 from the diskette VTOC on disk. 


Diskette VTOC read/write performs the following — If read next, use parameter list to direct disk 
functions: lOS in VTOC format-1 area scan. 
— If read next-same label, set up scan mask for 
e Prepare the diskette disk |OS. 
— lf requested format 1 not found, set parameter 
e Read/write format 1 list return code and return to caller; otherwise, 
place requested format-1 sector/displacement 
e Convert format 1’s to header 1's in parameter list. 
— Unless existence test, move format 1 to caller's 
¢« Orient autoloader device carriage 1/O area. 
Diskette VTOC read/write is called via a transfer SVC e Process format-1 write request: 
instruction and a parameter list pointed to by XR2. — Build IOB for disk IOS to read sector specified 
in parameter list. 
Diskette VTOC read/write processes are listed below: — Move format 1 from caller |/O area into sector 
just read and direct disk IOS to write sector 
e Determine the function requested. back to disk. 


— Return to caller. 
e Prepare diskette: 


— If autoloader diskette drive, select diskette. « Convert format 1's to header 1's: 

— Read and verify the volume label and place — Verify lock sector. 
volume label and physical attribute indicators in — Convert format 1’s in diskette VTOC area on 
the SCA. disk back to header 1’s and write back to 

— Create and write the lock sector. diskette. 

— Convert header 1’s into format 1’s and write to 
diskette VTOC area on disk. e Return autoload device carriage to home position. 


Diskette VTOC 


Control Storage 
hisirheee reosrwie [| comcnre 
via Transfer SVC (#CSVI) Diskette VTOC Disk IOS and 
Instruction with Read/Write ee ac 
Parameter List (#CSVJ) 
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Chart 6.2.5 Diskette VITOC Read/Write Control Flow 
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Message Retrieve 


The message retrieve routine locates the message text 
for an MIC (message identification code) passed by the 
calling program. It ensures a valid message retrieve by 
checking the parameter list for valid indicators and the 
message member pointer in the appropriate 
communications region for a nonzero disk sector 
address. The message retrieve routine is invoked via the 
transfer SVC instruction with XR2 pointing to the 
parameter list. 


Message retrieve processes are listed below: 


e Perform the following for the request: 
— Check message retrieve parameter list for valid 
indicators. 
— Check message member pointers in appropriate 
communications region for a nonzero disk 
sector address (SSN). 


¢« Direct disk |OS to scan message member for sector 
identified by MIC greater than or equal to the 
requested MIC. 


e Find desired message by reading message member 
sector. 


e Place message in caller's buffer and message length 
in parameter list. 


e If error detected, return error MIC in parameter list. 


e Return to caller. 


Calling Program Control Storage 
via Transfer SVC Message Retrieve 


Instruction with RIB (#MGRET) 
and Parameter List 
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Chart 6.2.6 Message Retrieve Control Flow 
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SYSIN 


SYSIN retrieves records from either the keyboard or 
from a library procedure member. SYSIN performs 
substitution and procedure control expression 
processing. SYSIN is called via a transfer SVC 


instruction with RIB, and XR2 pointing to the parameter 


list. The primary users of SYSIN are the initiator (Chart 
3.1.1) and the syntax checker (Chart 6.2.14) 
subfunctions. 


The following SYSIN processes are shown in Chart 


6.2.7: 


1 Perform the following mainline processing, routing 
where necessary: 


¢ Get statements from procedure (#MASYL). 


e If procedure control expression processing is 
required: 


Perform // IF ACTIVE existence testing. 
Perform blocks existence testing. 

Perform file, switch, member, and volume 
ID existence testing. 

Route for IF testing for IF, CANCEL, ELSE, 
EVALUATE, GOTO, TAG, RESET, and 
RETURN statements. 

Perform INQUIRY, JOBQ, DISPLAY, 
MRTMAX, CONSOLE, and DSPLY, 
ENABLED, LISTDONE, SECURITY, and 
EVOKED testing. 


e Set return code and return to calling program. 


2 Get input from keyboard and place in user buffer. 


3 Process all errors detected by SYSIN. 


4 Perform detail statement processing. 


5 Perform detail statement processing. 


6 Perform detail statement processing. 


7 Perform detail statement processing. 


8 Write records to history file if logging is specifed by 
LOG statement. 
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Calling Program 

via Transfer SVC 

Instruction with RIB 

and Parameter List SYSIN Keyboard, Error and Message 
Routines (#CLEKM) 


= 
SYSIN Mainline ae : 
(#CLSS) (Chart 6.2.9) 


Source Get 


(#MASYL) SYSIN IF Statement and Substitution 


Routines (#CLIS) 


Message Retrieve 
(Chart 6.2.8) 


SYSIN IF ACTIVE and EVALUATE 
Routines (#CLAE) 


SYSIN IF, Existence, and File Size Test 
Routines (#CLBEF) 


IF Block Existence and Volume ID 
Test (CLBL) 


IF File, Member, Switch Existence 
Tests (CLEX) 
j- 


History File 
Put 
(Chart 6.2.12) 
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Chart 6.2.7 SYSIN Control Flow 
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SYSLIST 


SYSLIST provides a means of printing or displaying 
system output to the user. SYSLIST processes two 
types of system output: Type 1 comes from a message 
member, and Type 2 comes from a system program. 
SYSLIST is called via a transfer SVC instruction with 
RIB, and XR2 pointing to a parameter list. The primary 
users of SYSLIST are IBM utilities and IBM program 
products. 


Calling Program 
via Transfer SVC 
Instruction with 
RIB and SYSLIST 
Parameter List 


SYSLIST 
Mainline 
(#CLST) 


Chart 6.2.8 SYSLIST Control Flow 
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The following SYSLIST processes are shown in Chart 
6.2.8: 


1 Perform the following mainline processing, routing 
where necessary: 


¢« If Type 1 output (from message member), 
check parameter list for message member to 
use, get message from member and place it in 
SYSLIST buffer. 


¢« If Type 2 output (from system program), use 
data supplied by caller. 


« If SYSLIST device is printer, allocate printer and 
build buffer, and print message. 


2 If SYSLIST device is display (CRT), build the work 
station data management parameter list and display 
the message. 

3 Get message from appropriate message member. 

4 Allocate printer if applicable. 


5 Print message. 


6 Issue error messages. 


Work Station 
Data Management 


Message Retrieve 4 
(4MGRET) 


Printer Allocate 


Printer lOS via 
IPTR Macro 


SYSLOG 
(Chart 6.2.9) 
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SYSLOG The following SYSLOG processes are shown in Chart 
6.2.9: 

SYSLOG provides a method of printing or displaying 

messages. SYSLOG processes six types of messages: 1 Perform the following mainline processing, routing 


where necessary: 
e Type 1: Message member messages not requiring a 


response and, optionally, with variable-length data « If Type 2, 2R, or 3 message, move caller's 
inserted message to SYSLOG storage. 

« Type 1R: Message member messages requiring a ¢ Build format line and log to history file, if 
response required. 

« Type 2: User program messages not requiring a - If Type 1, 1R, or 4 message, move message 
response from message member to main storage. 

¢ Type 2R: User program messages requiring a 2 Get copy of message sent to console; send 
response message indicating response taken. 

« Type 3: User program messages with a format-line 3 Process MSG command. 
request 


4 Perform PUT/GET to work station data 
e Type 4: Message member messages with 8 bytes management (WSDM). 
of data inserted 


5 If message’s alertable flag is on and alert task is 
¢ Type 5: Program interface to MSG command active, issue message to host. 


SYSLOG is called via a transfer SVC instruction with 6 If requested, log messages to the history file. 
RIB, and XR2 pointing to a parameter list. 


7 ~~ ~Retrieve message. 


8 Terminate. 
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Calling Program 
via Transfer SVC 
Instruction with 
RIB and SYSLOG 
Parameter List 


Chart 6.2.9 SYSLOG Contro! Flow 
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MSG Command 
Processor 
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Interface 


Work Station 
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History File 
Put 
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Termination 
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History File Put « Add the following information to the entry in 


the buffer: 
The history file put subfunction places OCL, error — Terminal ID from TUB. 
messages, and operator responses into the history file. — User ID from JCB or TUB. 
The history file is not a data file, but it is located in the — Job ID from JCB. 
system area on disk. The following history file status — Time-of-day from control storage timer 
information is maintained in the system communications routine. 
area (SCA): — Message type control bits. 
e Beginning sector address e When entire entry is built, place in sector (in 
1/O buffer) following the previous current entry; 
e Size in sectors if sector overflows, get new sector and update 


status information. 
e Sector containing current entry 


« Direct disk 1OS to write to disk. 
e Error condition 


e Route for the remaining processes. 
The history file put subfunction is invoked by transfer 


SVC instruction with XR2 pointing to a 10-byte 2 Get current sector from history file and place in !/O 
parameter list. buffer. 

The following history file put processes are shown in 3 If history file no-wrap was specified and number of 
Chart 6.2.10: sectors remaining in system history file is less than 


20 per cent, write to HISTCOPY disk file. 
1 Do the following: 


e Get current status from SCA. If no error, get 
history file start address, size and address of 
current entry. 

« Get input text for current entry, strip-off blanks, 


and place in buffer. 


Control Storage 


Calling Program History File 
via Transfer SVC Put 


Instruction with RIB (#HFPU) 

and Parameter List 3 History File 
Copy 
(FHFCOPY) 
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Chart 6.2.10 History File Put Control Flow 
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Supervisor Task Attach 

Supervisor task attach performs the necessary processes 
to attach a new task to the system. The supervisor task 
attach subfunction is called by a transfer SVC 
instruction, with XR1 pointing to the parameter list. The 
task TB is build during the transfer to supervisor task 
attach. 

Supervisor task attach performs the following: 


° Initialize work areas. 


¢ Calculate storage required to load or execute the 
program. 


e Ensure that task can be attached. 


¢« lf load request, build and initialize a new program 
block (PB). 


¢ Set the TB and JCB for task initiation. 
¢ Set registers for load of, or transfer to, the task. 


e Issue load or transfer. 


e Return the TB address in XR1 for successful attach; 
otherwise, return the error return code. 


Control Storage Routines 


Calling Program 
via Transfer SVC 
Instruction with 

Parameter List Ri ee eee ee a ee 


Supéemisor ask $F" " — li “Seep fee Soe Se ee 
Attach/Reorg/ Detach 
(HSVAT) 


To: New Task 
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Chart 6.2.11 Supervisor Task Attach Control Flow 
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Supervisor Task Detach/Change Origin Point 


~ Supervisor task detach/change origin point performs the 
processing required to detach a task from the system or 
to change a task’s main storage point of origin. It is 
called by a transfer SVC instruction with XR1 pointing to 
a parameter list. 


The following processes are performed for a task detach 
request: 


° Initialize all work areas. 


e Find the largest swappable region size in the system 
(not including this task). 


e Decrement any counters incremented by the task 
being detached. 


« Free any FSBs or format 1’s associated with the 
task. 


e If task was an evoked or MRT task, free JCB and 
WSWA. 


« Release any other RBs associated with the task. 


e Mark the task as a subtask and allow subtask 
termination to purge the system of the TB and the 
last request block-program block (RB-PB) 
combination. 


Calling Program 
via Transfer SVC 
Instruction with 
Parameter List 


Supervisor Task 
Attach/Reorg/ Detach 
(4SVAT) 


The following processes are performed for a change in 
origin: 


° Initialize all work areas. 


e Find the largest swappable region size in the system 
(not including this task). 


¢« Calculate sizes required for this task. 


e Determine if enough system resources are available 
to allow the change in origin. 


e If this is a load request, initialize the PB. 
e Set registers for load or transfer to the task. 


e Issue load or transfer. 


Control Storage Routines 


To: 
New Task or 
Subtask Termination 
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Chart 6.2.12 Supervisor Task Detach/Change Origin Point Control Flow 


2-206 


This document contains restricted materials of IBM. LY21-O0590-4 
©Copyright IBM Corp. 1983, 1984, 1985, 1986 


Syntax Checker The following syntax checker processes are shown in 
Chart 6.2.13: 
The syntax checker performs the following functions: 


e Read control statements. 
e Checks for valid verb in the utility control statement 


« Find and load specification module. 
e Indicates in the communications table the verb and 
parameter(s) specified in the control statement and e Analyze verbs. 
any syntax errors detected 


e Process parameters if parameters present. 
e Checks that parameter values are valid and are used 


in valid combinations e Perform end-of-statement check. 


« Places parameter values (or values that are to be e Return to caller. 
substituted for parameter values) in the 
communications table output area 


The syntax checker is called with XR2 pointing to the 
syntax checker parameter list, which points to the verb 
list and the communications table. The verb list defines 
which verb, or verbs, are valid for this particular call to 
the syntax checker; this allows the caller to define the 
order in which statements may be coded. The 
communications table specifies the name of the syntax 
specification module (if any) that should be loaded from 
the system library. 


Calling Program via 
Load SVC Instruction 
with XR2 a> 
Parameter List 


SYSIN 
(Chart 6.2.7) 


Syntax Checker 
(HUSYX) 


System Find 
(Chart 6.1.2) 
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Chart 6.2.13 Syntax Checker Control Flow 
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Information Retrieval 

The information retrieval transient allows user programs 
to access certain fields within privileged control blocks 
or the local area on disk. User programs invoke the 
transient with the transfer SVC instruction and a 
parameter list (pointed to by XR2) specifying the 
operation to be performed and the data area to be 
accessed. 


The following information retrieval processes are shown 
in Chart 6.2.14: 


Process user parameter list: 
« Move list to transient area. 


e Verify fields in parameter list; if invalid entries, issue 
an option 3-only message. 


e Get JCB address from the TB. 
If put request, update any one of the following: 
e UPSI switch value. 
e Program message member 1 and 2. 
e System and user local data areas. 
¢ Compiler information block. 
e User message member 1. 
e JCB return code field. 
Calling Program 
via Transfer SVC 


Instruction with 
Parameter List 


Information Retrieval 


Transient 
(#SVINF) 


If get request, return one of the following: 
e Date format. 

e Program date. 

e Session date. 

e UPSI switch value. 

e —_ Inquiry latch indicator. 

« System and user local data areas. 

¢ Compiler information block. 

¢ Program attribute indicator (for NEP). 
e Maximum number of requesters (for MRT). 
e Number of line per page. 

« System list device. 

e Unpacked Julian date. 


e Spool ID. 


SYSLOG Termination 


Chart 6.2.14 Information Retrieval Control Flow 
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Snap Dump 

The snap dump transient provides a formatted main 
storage dump when it is invoked by the transfer SVC 
instruction with XR2 pointing to the parameter list. The 
user either dumps the entire region of main storage, or 
specifies storage limits for the dump. 

Snap dump processes are listed below: 

« Move the parameter list to temporary area. 


e _ Initialize the work area. 


« Calculate the dump limits; if limits are invalid, issue 
error message and return to caller. 


e Get headings messages and dump limits for dump 
header. 


¢ Set up and print dump, line by line with SYSLIST. 


e Return to calling program. 


Calling Program Snap Dump SYSLIST 


(Chart 6.2.8) 


via Transfer Transient 
SVC Instruction (#SVDMP) 
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Chart 6.2.15 Snap Dump Control Flow 
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Diskette Data Save/Restore 


The diskette data save/restore routine performs two 
main functions: 


e Saves a disk file on diskette 

e Restores a disk file (saved on diskette) to disk 
The diskette data save/restore routine is called via a 
transfer SVC instruction with XR2 pointing to the input 
file DTF. The output file DTF is chained to the input 
DTF. 


The following diskette data save/restore processes are 
shown in Chart 6.2.16: 


1 Determine the function requested. 

2 If save request (using main storage data 
management): 
« Open the diskette and disk files. 


e Copy the embedded control record to beginning 
of buffer. 


e Call diskette and disk sector data managements 
to transfer the data. 


« When data transfer is complete, close files. 


e Return to caller. 
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If save request (using device-to-device subsystem 
or data compression): 


e Build disk and diskette IOBs. 


e Copy the embedded control record at beginning 
of buffer. 


e Call diskette |OS with chained IOBs to transfer 
the data. 


« Update file VTOC for the data transferred. 

e Return to caller. 

If embedded control record get request (using main 
storage data managment or device-to-device 
subsystem): 


e Open the diskette file. 


e Read the embedded control record and move it 
to the caller's buffer. 


° Return to caller. 


If restore request (using main storage data 
management): 


e Open the diskette and disk files. ~ 


e Call diskette and disk data managements to 
transfer the data. 


e When data transfer is complete, close files. 
e Return to caller. 


If restore request (using device-to-device 
subsystem or data compression): 


e Build disk and diskette IOBs. 


e Call diskette |OS with chained IOBs to transfer 
the data. 


« Update file format 1 to reflect data transferred. 


° Return to caller. 
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Chart 6.2.16 Diskette Data Save/Restore Control Flow 
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Tape Data Save/Restore 


The tape data save/restore routine performs two main 
functions: 


¢ Saves disk file(s)/library/folder on tape. 


¢ Restores disk file(s)/library/folder (saved on tape) to 
disk. 


The tape data save/restore routine is called via transfer 
SVC instruction with XR2 pointing to the input file DTF. 
The output file DTF is chained to the input DTF. 


The tape data save/restore processes are listed below: 


1 Acquire TWS to save information across multiple 
calls in a step; determine the function requested. 


2 =siIf save request on 8809 (1/2-inch tape) or 6157 
(1/4-inch tape) on 5362 with 9332 disks: 


e Build tape HDR1 and HDR2 mask (first pass). 


e Build two pairs of tape and disk IOBs (first 
pass). 


e Append UHL1 and UHL2 supplied by the caller 
to the HDR1 and HDR2. 


e Call tape [OS (with nowait), via chained IOBs, to 
transfer the data. 


e If two tape IOB pairs are outstanding, wait for 
previous IOB’s request to complete and return 
completions to caller. 

e If last file transfer request, wait for all 
oustanding requests to complete and return 


completions to caller. 


e Call close to process END specification from the 
tape file statement. 


e Return to caller. 
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If restore request on 8809 (1/2-inch tape) or 6157 
(1/4-inch tape) on 5362 with 9332 disks: 


Build tape and disk IOBs. 


Call tape IOS (with wait) via chained IOBs, to 
transfer the data. 


If more files are to be restored, return next 
file’s UHL1 and UHL2 to caller’s buffer. 


Update file format 1 to reflect data transferred. 
If this is the last file to be restored, call close to 
process END specification from the tape file 


statement. 


Return to caller. 


If save request on 1/4-inch cartridge: 


Build tape HDR1 and HDR2 mask (first pass). 
Build four tape and two disk IOBs (first pass). 


Append UHL1 and UHL2 supplied by caller to 
the HDR1 and HDR2. 


Call tape IOS and disk IOS by using double 
buffering to transfer data to tape. 


If not the last file in group, return to caller when 
the last tape data IOB has been issued. 


If the last file in group, return to caller after all 
lOBs have completed and call close to handle 
the END specification from the file statement. 


If restore request on 1/4-inch cartridge: 


Build four tape and two disk IOBs. 


Call tape |OS and disk lOS using double 
buffering to transfer data to disk. 


If more files are to be restored, return next file’s 
UHL1 and UHL2 to caller's buffer. 


Update file format 1 to reflect data transferred. 
If this is the last file to be restored, call close to 


process END specification from the tape file 
Statement. 
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$0590366-2 
Chart 6.2.17 Tape Data Save/Restore Control Flow 
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Diskette Magazine Drive Search Routine 


The diskette magazine drive search routine performs two 
main functions: 


¢ Checks for the existence of the specified diskette 
¢« Searches for the specified file 


Diskette magazine drive search is called via a transfer 
SVC instruction with XR2 pointing to the parameter list. 


Diskette magazine drive search processes are listed 
below: 


e Determine the function required. 


e If search for specific file: 

— If the search is for the first volume of the file, 
search the range of diskettes until the first or 
the only volume is found. 

—  \f the search is for the last volume of the file, 
search the range of diskettes until the last or 
the only volume is found. 

— lf the search is for any volume of the file, 
examine the location logically following the 
Original location to determine whether the 
volume of the specified file is mounted. 


e If search for diskette existence: 

— If the search is for the first diskette, with skip 
empty slots specified, search the range of 
diskettes until the first diskette is found. If the 
request does not include the skipping of empty 
slots, issue a message directing the operator to 
insert the diskette in the requested slot. 

— lf the search is for any volume of the file, 
examine the location logically following the 
Original location to determine whether the 
volume of the specified file is mounted. 


Calling Program 


i Diskette VTOC 
via Transfer SVC plenere Wagseite 


Drive Search Read/Write 


Instruction with (Chart 6.2.5) 


Parameter List (#CSMS) 


$0590318-0 
Chart 6.2.18 Diskette Magazine Drive Search Routine Control Flow 
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Diagnostic Aids Function 


The diagnostic aids function consists of the main 
storage programs provided to assist CEs/CSRs and 
PSRs in diagnosing and, where feasible, correcting 
system failures caused by a system or task malfunction. 
This function includes the following programs which run 
under the diagnostic aids mainline (6FEAIDS) and the 
diagnostic aids router (SFECNT): 


e Mainline and router processing Chart 7.1.0 
¢ Error Recording Analysis Chart 7.1.1 
procedure (ERAP) 
« Dump utilities Chart 7.1.2.n 
e Patch Chart 7.1.3 
¢« Trace Chart 7.1.4 
« APAR Chart 7.1.5 
« SETDUMP Chart 7.1.6 
« Dump file analysis Chart 7.1.7 
¢« Diskette diagnostic utility Chart 7.1.8 
¢ Tape volume statistics Chart 7.1.9 


The diagnostic aids function also includes the following 
programs that are invoked independent of the diagnostic 
aids mainline and router programs: 


¢ PTF apply/copy Chart 7.2 
¢ System measurement facility Chart 7.3.n 
¢ Service logging Chart 7.4.n 
e Test request Chart 7.5 
¢ Communications test Chart 7.6 
e Online problem determination Chart 7.7 
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MAINLINE AND ROUTER SUBFUNCTION 


Requests for diagnostic aids are passed to the 
diagnostic aids mainline program ($FEAIDS). The 
mainline program checks for the validity of the requests 
and initializes for the diagnostic aids shown in Chart 
7.1.0. 


The following chart shows routing based on the request 
received from the applicable procedure (with listed 
keyword): 


Request Utility Called 
APAR $FEAPR, $FEALK, 
$FESLK, FETLK 
DFA $FEDFA 
DIAGCOPY $FECPY 
DUMP CONTROL $FECON 
DUMP DISK $FEDSK 
DUMP IOC $FEIOC 
DUMP MAIN $FESTR 
DUMP MCODE $FEMCD 
DUMP PLD $FEPDD 
DUMP PTF $FEPTF 
DUMP SERVLOG- $FESRV 
DUMP STATUS S$FEMNT 
DUMP TRACE $FEDTR 
DUMP TAPE $FETAP 
DUMP (TWA, $FESYS 
VTOC, SPOOL, 
or JOBQ) 
ERAP $ERAP 
l11DIAG $ DAMP 
LOGPLD $ FEPDL 
PATCH $FEDSK 
PTF COPY/APPLY $FECHK 
PTF REMOVE $FEPRM 
SERVLOG $FECNT 
SETDUMP $FEACD 
TAPESTAT $7SB1 
TRACE CRT $FETRC 
TRACE BATCH $FEBTR 


Chart 7.1.0 shows the control flow for diagnostic aids 


mainline and router processing: 


Note: Diagnostic aids mainline contains common 
subroutines used by all diagnostic aids that execute 


under it. These subroutines are shown in Chart 7.1.0, 


but are not shown in detail in other 7.1.n charts. 


1 Perform common initialization for diagnostic aids 


utilities execution: 


e Initialize Common data areas. 


e Initialize base subroutines for use by requested 


utility. 


e If necessary alter MICOOO1 to show SSP 
release and modification level, date, and 
execution-time information. 


« Allocate and open requester’s work station file. 


e If caller is Test Request or System test, load 


and pass control to ERAP utility; otherwise, 
load and pass control to the diagnostic aids 
router. 


9 


Process utility control statements. 


Use $FETAB (syntax table for diagnostic aids utility 
control statements) to check syntax. 


If APAR diskette input, preprocess diskette file. 
If APAR tape input, preprocess tape file. 


If call is for DUMP MAIN, DUMP TRACE, DFA, or 
APAR, then display dump file status. 


Process requests for service log recording. 
Terminate diagnostic aids (the individual diagnostic 
aid utilities call the ENDIT routine in SFEAIDS to 


reload the router which calls termination). 


Perform requested utility processing. 


10 Perform subroutine (SFEAIDS) functions as required. 
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OCL from the Service 
Procedure or Enhanced Help 
Requests via Command 


Processor 2 and 
Initiator 


Diagnostic Aids Mainline 
#FEAIDS 


Common Subroutines: 


e Abnormal Termination 

e Halt/SYSLOG 

e Disk 1/0 

e Work Station/Printer Routing 
e Binary-Hex Converter 

e Binary- Decimal Converter 
e Hex-Binary Converter 

e Decimal-Binary Converter 
e Load a Utility 

e Retrieves a Message 

e Terminate a Utility 

e Move Blocks of Data 

e Load Overlay Modules 

e Save Registers in Stack 

e Process Work Station |/O 
e Process Print Requests 

e Return to Caller in Stack 


Diagnostic Aids 
Router 
(SFECNT) 


Test Request 
(Chart 7.5) 

or 
System Test 
(ZSTLOAD) 


Error Recovery 
Analysis Program 
(Chart 7.1.1) 


(ABORT) 
(ERROR) 
(DISKIO) 
(GENIO) 
(BINTOHEX) 
(BINTODEC) 
(HEXTOBIN) 
(DECTOBIN) 
(FETCH) 
(FINDMIC) 
(ENDIT) 
(MOVEIT) 
(OVERLAY) 
(SAVEREGS) 
(WSIO) 
(PRINT) 
(RETURN) 


Syntax Checker 


$0590155-1 


Chart 7.1.0 (Part 1 of 2) Diagnostic Aids Mainline and Router Control Flow 
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10 


ERAP Utility 
(Chart 7.1.1) 
Dump Utilities 
(Chart 7.1.2.n) 
PATCH Utility 
L3 (Chart 7.1.3) ¥ 
Trace Utility 
(Chart 7.1.4) 
| Ls APAR Utility Z 
pump Fue Ez (Chart 7.1.5) Z 
Maintenance 
(SFEMNT) SETDUMP Utility 


Dump from APAR 
Diskette 
(SFESI1) 


Dump from APAR 
Tape 
(SFETI1) 


Diagnostic 
Aids 
Router 
(SFECNT) 


(Chart 7.1.6) 


Service Log 


7 
a Recording Transient 


Dump File Analysis 
(Chart 7.1.7) 


(Chart 7.4) 


Diskette Analysis 
Utility 
(Chart 7.1.8) 


Tape Volume 
Statistics Utility 
(Chart 7.1.9) 


Product Level 
Data Dump 
(Chart 7.1.2.4) 


Termination 


$0590156-1 


Chart 7.1.0 (Part 2 of 2) Diagnostic Aids Mainline and Router Control Flow 
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ERROR RECORDING ANALYSIS PROCEDURE 3 Use $FEAIDS common subroutines to do the 


(ERAP) SUBFUNCTION following: 

The ERAP subfunction is used to display or print data e Put formatted tables to printer. 

that is logged for all devices attached to the system. 

Device-specialized ERAP modules format information ¢ Put formatted tables to display station. 

from |/O counter tables and error logging tables for 

their respective devices. The information printed or « If called by system test or test request, route 
displayed by the mainline ERAP module is dependent on control back: otherwise, terminate. 


user-selected options. 


4 Perform the following conversions, as required: 
All ERAP modules use subroutines provided by 


diagnostic aids mainline (SFEAIDS); these subroutines e Timer units to time-of-day. 
are shown in Chart 7.1.0. 


e Time-of-day to timer units. 
The following ERAP processes are shown in Chart 7.1.1: 


e Multiplication. 
1 Do the following: 


e« Division. 
e Prompt for device. 


5 Print or display summary formatted report. 
« Prompt for report options (summary, elapsed 


time counters, all devices). 
¢« Route for specific device. 
2 Do the following by device: 


« Format !/O counter table, error counter table, 
and error history table for specified device. 


« Reset |/O counter table or error counter table §#f 
requested. 
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SERVICE Procedure Test Request (Chart 7.5) 


or or 
Enhanced Help System Test (ZSTLOAD) 


Diagnostic Aids Mainline 
$FEAIDS 


ee eee i a ee 


Device Formatters: 


i Main Storage Processor (SERO3) 


aes ig Control Processor (S$ERO2) 


aed Diskette Drive (SERD2) 
petp| Diskette Magazine Drive (SERD3) 
mo _Lacl Work Staton Convoler ERC) 


Remote Work Station Controllers (SER8A) 
le. 3262 Printer (SERE2) 


Local Work Stations (SERCE) 


pele] Remote Work Stations (SERAE) 
mete] SOIC SRB) 
mel MUCATELCAS”~S~S*~*~*~S~S~*SSERG) 
ee Auiccal CSB) 
a 
mol 8509 Tape Dive SCSI) 
ia i 


ewok en 


Summary Formatter (SERSM) 
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Common Diagnostic 
Aids Subroutines 


ee | 


Diagnostic 
Aids 
Router 
(SFECNT) 


ERAP 
Mainline 
(SERAP) 


Diagnostic 
Aids 4 


Conversion 
Routines 
(SFECNV) 


Chart 7.1.1 ERAP Processing Control Flow 
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DUMP UTILITIES SUBFUNCTION 


The dump utilities are used to display system and task 
dump files from disk, diskette, or tape, or to display other 
areas frequently required to diagnose an abnormal 
termination problem. 


All dump utilities use subroutines provided by diagnostic 
aids mainline (SFEAIDS); these subroutines are shown 
in Chart 7.1.0. Other dump utilities processes are 
shown in Charts 7.1.2.1 through 7.1.2.12: 


Diagnostic Aids Mainline 
$FEAIDS 


Common Diagnostic 
Aids Subroutines 


Dump File 
Maintenance 


Main Storage 


Diagnostic (SFEMNT) Dump Utility 
Aids Copy Diskette /Tape (S$FESTR) 
Router 


APAR File to Disk 
(SFECNT) 


(SFESI1 /$FETI1) 


Dump Trace 


Files 
(SFEDTR) 


Dump File 


Analysis 
(Chart 7.1.7) 


$0590158-1 


Chart 7.1.2.1 Display System or Task Dump Control Flow 


2-222 
This document contains restricted materials of IBM. LY21-0590-4 
©Copyright IBM Corp. 1983, 1984, 1985, 1986 


Diagnostic Aids Mainline 
$FEAIDS 


Common Diagnostic 


| 
| 
Aids Subroutines 
| 


Disk Dump 
(S$FEDSK) 


Diagnostic 
Aids 
Router 
(SFECNT) 


$0590159-0 
Chart 7.1.2.2 Disk or Diskette Storage Areas Dump Control Flow 


Diagnostic Aids Mainline 
$FEAIDS 


Common Diagnostic 
Aids Subroutines 


System 

Areas 

Dump 
Diagnostic (SFESYS) 
Aids 


Copy Diskette /Tape 
Router APAR File to Disk 


(SFECNT) ($FESI1 /$FETI1) 


$0590160-1 
Chart 7.1.2.3 VTOC, TWA, Spool File, or Job Queue Dump Control Flow 


Diagnostic Aids Mainline 
$FEAIDS 


Common Diagnostic 
Aids Subroutines 


ee 


Dump Product 
Level Data 
(S$FEPDD) 


Diagnostic 
Aids 
Router 
(SFECNT) 


Copy Diskette /Tape 
APAR File to Disk 
(SFESI1 /$FETI1) 
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Chart 7.1.2.4 Display Product Level Data Dump Control Flow 
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Diagnostic Aids Mainline 
$FEAIDS 


Common Diagnostic 
Aids Subroutines 


Dump 1/0 


Copy Diskette/Tape 


Diagnostic APAR File to Disk pioce ree! 
ne tO VIS 

i ($FEIOC) 

Aids ($FESI1 /$FETI1) 

Router 


(SFECNT) 


Prepare Disk 
File 
(SFEMNT) 
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Chart 7.1.2.5 1/O Controller Storage Dump Area Dump Control Flow 


Diagnostic Aids Mainline 
$FEAIDS 


Common Diagnostic 
Aids Subroutines 


Dump Service 


Copy Diskette/Tape 


. . Log 
Diagnostic APAR File to Disk (SFESRV) 
Aids (SFESI1 /SFETI1) 

Router 


(SFECNT) 


Prepare Disk 
File 
(SFEMNT) 
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Chart 7.1.2.6 Service Log Dump Control Flow 
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Diagnostic Aids Mainline 
$FEAIDS 


Common Diagnostic 
Aids Subroutines 


Dump Microcode 


Copy Diskette /Tape 


. Tables 
Diagnostic APAR File to Disk (SFEMCD) 
Aids (SFESI1/$FETI1) 

Router 


(SFECNT) 


Prepare Disk 
File 
(SFEMNT) 
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Chart 7.1.2.7 Microcode Patch Table Dump Control Flow 


Diagnostic Aids Mainline 
$FEAIDS 


Common Diagnostic 
Aids Subroutines 


Dump Control 


Copy Diskette /Tape 


Storage 
Diagnostic APAR File to Disk (SFECON) 
Aids (SFESI1 /$FETI1) 

Router 


(SFECNT) 


Prepare Disk 
File 
(SFEMNT) 
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Chart 7.1.2.8 Control Storage Dump Area Dump Control Flow 
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Diagnostic Aids Mainline 
$FEAIDS 


Common Diagnostic 
Aids Subroutines 


Copy Diskette/Tape hg Bae 
Diagnostic APAR File to Disk ($FEPTF) 
Aids (SFESI1 /$FETI1) 
Router 


(SFECNT) 


Prepare Disk 
File 
(SFEMNT) 
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Chart 7.1.2.9 PTF Logs Dump Control Flow 


Diagnostic Aids Mainline 
$FEAIDS 


Common Diagnostic 
Aids Subroutines 


Copy Diskette/Tape 


Diagnostic APAR File to Disk 7 Dump Task Dump 
Aids ($EESI1 /$FETI1) Display Dump and System Trace 
Router File Status Files 

(SFECNT) (SFEMNT) (SFEDTR) 


Start/Stop 


Trace Logging 
(#FESLG) 


$0590166-1 
Chart 7.1.2.10 Dump Trace Files Dump Control Flow 
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Diagnostic Aids Mainline 
$FEAIDS 


Common Diagnostic 
Aids Subroutines 


Dump File 
Maintenance 


Diagnostic Srey 


Aids 


Copy Diskette/Tape 
Router APAR File to Disk 
(SFECNT) (SFESI1 /$FETI1) 


$0590319-1 
Chart 7.1.2.11 Dump Status Control Flow 


Diagnostic Aids Mainline 
$FEAIDS 


Common Diagnostic 
Aids Subroutines 


ee 


Tape Dump 
(SFETAP) 


Diagnostic 
Aids 
Router 
(SFECNT) 
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Chart 7.1.2.12 Tape Storage Areas Dump Control Flow 
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PATCH SUBFUNCTION 


The patch utility is used to display or modify disk or 
diskette storage. 


Patch uses subroutines provided by diagnostic aids 
mainline (SFEAIDS); these subroutines are shown in 
Chart 7.1.0. Other patch subfunction processes are 
shown in Chart 7.1.3: 


1 Read control statements and determine that patch 
was requested. 


2 Perform patch processing: 


e If request is for disk data, do the following: 
— Get data from disk (via DISKIO subroutine). 
— Modify the data as requested. 
— Write data back to disk (via DISKIO 
subroutine). 


e If request is for diskette, do the following: 

— Get data from diskette (via diskette IOS). 
Modify the data as requested. 
Write data back to diskette (via diskette 
IOS). 


3 Terminate via ENDIT subroutine. 


4 Perform subroutine processes required by $FEDSK. 


Diagnostic Aids Mainline 
$SFEAIDS 


Common Diagnostic 
Aids Subroutines 


Dump 
Disk / Diskette 
and Patch 
(SFEDSK) 


Diagnostic 

Aids 

Router Control Storage 
(SFECNT) 


$0530167-0 
Chart 7.1.3 Patch Utility Control Flow 
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TRACE UTILITY SUBFUNCTION 


The trace utility is used to select events to be traced. 
Trace uses subroutines provided by diagnostic aids 
mainline (SFEAIDS); these subroutines are shown in 
Chart 7.1.0. Other trace subfunction processes are 
shown in Chart 7.1.4: 


1 Read control statements and determine TRACE 
requested. 


2 Perform, and route for, trace processing requested. 


3 Get information on trace profile selected by 
requester. 


4 Initiate requested trace function. 


5 Perform subroutine processes required by trace 
utility. 


Diagnostic Aids Mainline 
$FEAIDS 


eww ww i i = 


Common Diagnostic 
Aids Subroutines 


Profile Retrieve 3 


Diagnostic 
(SFEPRO/$FEPR1) 


Aids 
Router 
(SFECNT) 


Chart 7.1.4 Trace Utility Control Flow 


This document contains restricted materials of IBM. LY21-0590-4 
©Copyright IBM Corp. 1983, 1984, 1985, 1986 


Diagnostic Aids 
Trace Utility 


(SFETRC for 


Interactive Trace 
or 

$FEBTR for 
Batch Trace) 
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APAR UTILITY SUBFUNCTION 3 Route for required APAR processing. 


The APAR utility is used to collect information for APAR 4 Stop logging trace files to disk, so files can be 
submission or to diagnose a problem other than in a copied. 
real-time environment. 


5 Copy system data areas to diskette or tape via 


APAR uses subroutines provided by diagnostic aids diskette or tape data management. 
mainline (SFEAIDS); these subroutines are shown in 
Chart 7.1.0. Other APAR subfunction processes are 6 Perform additional (module 2) APAR processing. 


shown in Chart 7.1.5: 


7 Perform additional (module 3) APAR processing 
1 Read control statements and route control to APAR (copy spool file). 


utility. 


8 Perform termination processing. 
2 Perform APAR processing requested: 


9 Perform subroutine processes required by APAR 
e Analyze dump files. utility. 


« If there is a work station requester, and no 
dump file name was entered in the procedure, 
put up dump file status screen. 


« Select the task dump to copy to APARFILE. 


« If the DUMPFILE parameter is entered in the 
invoking procedure, select it for APARFILE. 
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Chart 7.1.5 APAR Utility Control Flow 
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SETDUMP SUBFUNCTION SETDUMP uses subroutines provided by diagnostic aids 
mainline (SFEAIDS); these subroutines are shown in 
SETDUMP is used for the following: Chart 7.1.0. Other SETDUMP subfunction processes are 
shown in Chart 7.1.6: 
e To specify the hardware and software address, 
compare values to stop the main storage processor 1 Read control statements and route control to 
(MSP) long enough to take a task dump at a SETDUMP. 
specific main storage address. 
2 Perform requested SETDUMP processing: 
e To suspend a task after a task dump has been 
taken. « Resume any jobs suspended by address 
compare. 
« To force a task dump of a specific task. 
« Validate hardware and software compare 
values. 


« Create parameter list for control storage dump 
transient (SACDUMP). 


3 Process dump request from SETDUMP. 
4 Terminate via ENDIT subroutine. 


5 Use FEAIDS subroutines as required. 


Diagnostic Aids Mainline 
$FEAIDS 


Common Diagnostic 
Aids Subroutines 


Diagnostic Aids 
SETDUMP or 
Address Compare 
Dump 
(SFEACD) 


Diagnostic Control Storage 
Aids 
Router 
(SFECNT) 


| Set Hardware and 

) Software Values 3 
in Control Storage 
(SACDUMP) 


| 
| 
L 


$05390170-0 


Chart 7.1.6 SETDUMP Utility Control Flow 
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DUMP FILE ANALYSIS (DFA) SUBFUNCTION 


Dump file analysis (DFA) formats and displays selected 
areas of a storage dump. 


DFA uses subroutines provided by diagnostic aids 
mainline (SFEAIDS); these subroutines are shown in 
Chart 7.1.0. Other DFA subfunction processes are 
shown in Chart 7.1.7: 


1 Read control statements and determine function 
requested. 


2 Select system or task dump file to process. 
3 Format data and put to printer or display. 


4 Perform $FEAIDS subroutine processing, as 
required. 


Diagnostic Aids Mainline 
$FEAIDS 


Common Diagnostic 
Aids Subroutines 


Dump File 
Analysis Utility 
(SFEDFA) 


Diagnostic 
Aids 


: Dump File 
ee Copy Diskette/Tape Maintenance 
outer APAR File to Disk (SFEMNT) 

($FECNT) (SFESI1 /$FETI1) 


$0590171-1 
Chart 7.1.7 Dump File Analysis (DFA) Control Flow 
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DISKETTE DIAGNOSTIC UTILITY SUBFUNCTION 3 Process menu item 1 by writing and reading, and by 


reading the alignment tracks. 
The diskette diagnostic utility helps the user to isolate 


diskette (media) failures from diskette drive (hardware) 4 Process menu item 2 by reading all diskette sectors 
failures. The diskette diagnostic utility executes under and printing summary report documenting errors. 
diagnostic aids mainline (SFEAIDS) and requires a 

special test diskette. 5 Process menu item 3 by displaying statistical 


information record. 
The diskette diagnostic utility uses subroutines provided 


by diagnostic aids mainline (SFEAIDS); these subroutines 6 Process menu item 4 by performing multiple reads 
are shown in Chart 7.1.0. Other diskette diagnostic and optional writes to the specified sector. 
utility processes are shown in Chart 7.1.8: 
7 ~~ Process menu item 5 by copying diskette. 
1 Read control statements and determine that diskette 


diagnostic utility was requested. 8 Process menu item 6 by patching diskette. 


2 Perform the following mainline processing: 9 Use $FEAIDS subroutines as required. 


« Allocate the diskette drive. 


« Route for menu item selected: 
— 1, Test diskette drive. 
— 2, Scan diskette for errors. 
— 3, Print diskette error log. 
— 4, Recover data on a diskette. 
— 5, Copy data from one diskette to another. 
— 6, Display or change diskette sectors. 


« Terminate. 
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Chart 7.1.8 Diskette Utility Control Flow 
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TAPE VOLUME STATISTICS UTILITY 
SUBFUNCTION 


The tape volume statistics utility formats and prints tape 
volume statistical information for all tape devices on the 
system. The tape volume statistics utility uses 
subroutines provided by diagnostic aids mainline 
(SFEAIDS); these subroutines are shown in Chart 7.1.0. 
Other tape volume statistics processes are shown in 
Chart 7.1.8: 


1 Read control statements and determine that tape 
volume statistics utility was requested. 


2 Read tape volume statistics table from disk, format 
statistics, and display or print. 


3 Use FEAIDS subroutines as required. 


Diagnostic Aids Mainline 
$FEAIDS 


a Gm ame ae eee de eee eee ee eee ee eee oe 


Common Diagnostic | 
Aids Subroutines 


Tape Volume 
Statistics 
($TSB1) 


Diagnostic 
Aids 
Router 
(SFECNT) 
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Chart 7.1.9 Tape Volume Statistics Utility Control Flow 


2-236 
This document contains restricted materials of IBM. LY21-0590-4 
©Copyright IBM Corp. 1983, 1984, 1985, 1986 


PTF APPLY/COPY SUBFUNCTION 


The PTF apply/copy subfunction creates a library with 
the selected module replacements and checks to ensure 
that all prerequisite PTFs are also present. After creating 
the library of modules, it replaces the appropriate 
system modules with their respective replacement 
modules. 


The following PTF apply/copy processes are shown in 
Chart 7.2: 


1 If PTF copy selected, determine which files should 
be copied from diskette to work library. 


2 If PTF copy selected, build library of PTFs from the 
PTF file on diskette. 


3 If PTF apply/copy selected, verify release level and 
check to ensure that all prerequisite PTFs are to be 
copied/applied. 


4 For PTF copy, build PTF library and copy all 
specified modules; for PTF apply, apply module 
replacements to specified library. 


OCL from 
Service Procedure 


Diskette 
Control 
(S$FECTL) 


Library Maintenance 


Initiator 


PTF 
Prerequisite 
Checking 
(SFECHK) 
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Chart 7.2 PTF Apply/Copy Control Flow 
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SYSTEM MEASUREMENT FACILITY (SMF) 
SUBFUNCTION 


The system measurement facility (SMF) collects system- 
resource-uSage data that can enable the user to identify 
causes of poor system performance. SMF consists of 
three components: data collection collects data while 
user applications are executing and writes the data to 
the SMF data file on disk; the report.writer uses the data 
collected to print the type of report specified by the user 
(all, detail, mini, or summary); and the report file 
program uses the data collected to format the type of 
disk file specified by the user (all, detail, mini, or 
summary). 


SMF Data Collection 


SMF data collection collects statistical data about 
interactive and batch programs, the spooling function, 
the main storage and control storage processors, the 
disk drive, and the communications lines. SMF data 
collection is activated by the SMFSTART procedure 
command and is deactivated by the SMFSTOP 
procedure command. 


Note: The SMFSTOP procedure loads an additional 
copy of the SMF data collection program that terminates 


the currently executing copy. 


The following data collection processes are shown in 
Chart 7.3.1: 


1 Determine function requested. 


2 If SMFSTOP request, post active data collection 
task (see preceding note) for end of job. 


3 Process SMFSTART request by performing 
initialization: 


« Syntax check utility control statements. 
« Initialize control storage data areas. 
e Allocate SMF data file. 


« If data communications SMF specified, allocate 
SMF data communications microcode. 


¢« If 1/0 and SEC data by task was selected, build 
a system measurement block for each task. 
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« Collect the time-of-day date and system 
configuration information and write them to the 
SMF data collection file. 


Collect data: 


« Wait for SMF data collection time interval to 
elapse. 


e Determine if an SMF STOP request has been 
received. 


¢ Collect time-of-day, main storage usage 
information, and task work area usage data. 


¢ Call control storage SMF microcode to collect 
system event counters, |/O counters, device 
and data storage attachment (DSA) information. 


e If communications was selected: 

— Collect communications configuration 
information if there are any new lines active 
for this snapshot. 

— Collect communications utilization data for 
all active lines that are not new this 
snapshot. 


¢ Collect information on each active task: 

—  \f data-by-task was selected, collect |/O 
and SEC data by task from system 
measurement block. 

—  |f data-by-task was selected, collect data 
from each task that has terminated since 
last snapshot. 


« Write the data collected to the the SMF data 
collection file. 


Perform EOJ cleanup of SMF control storage data 
areas. 


Issue error message for SMF-detected errors. 
Exit to terminate. 
If 1/O or SEC data collection by task was in 


progress when a task terminates, clean up counts 
related to that task. 
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Chart 7.3.1 SMF Data Collection Control Flow 
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SMF Report Writer 


The SMF report writer formats and prints the 
performance statistics accumulated by SMF data 
collection. The report writer is a PLS program that prints 
records retrieved from the SMF data file on disk. The 
SMF utility report writer is invoked by either the SMF or 
SMFPRINT procedure command. 


SMF 

or SMFPRINT 
Procedure 
Commands 


Initiator 
(Chart 3.1) 


1,3,4,5 


SMF Utility 
Report Writer 
(SSMFLG) 


Disk Data 
Management 


Printer Data 
Management 


Interface 
Subroutine 
(SSMSUB) 


SYSLOG 


Chart 7.3.2 SMF Utility Report Writer Control Flow 
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The following SMF report writer processes are shown in 
Chart 7.3.2: 


1 Perform initialization. 

2 Read next logical record. 

3 Check for limits processing. 
4 Process logical record. 


5 Retrieve heading line to print from #SM#M2 
message member. 


6 = Print SME report. 


7 Terminate program. 


Message Retrieve 


Termination 
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This document contains restricted materials of IBM. LY21-0590-4 
©Copyright IBM Corp. 1983, 1984, 1985, 1986 


SMF Report File Program The following SMF report file program processes are 
shown in Chart 7.3.3: 
The SMF report file program formats and writes the 


performance statistics accumulated by SMF data 1 Perform initialization. 
collection to the report file. The report file program is a 

PLS program that writes records retrieved from the SMF 2 Read next logical record. 
data file on disk. The SMF utility report file program is 

invoked by either the SMF or SMFDATA file program. 3 Check for processing limits. 


4 Process logical record. 
5 Write SMF report file. 


6 Terminate program. 


SMF 

or SMFDATA 
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Initiator 
(Chart 3.1) 
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SMF Utility 
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Termination 
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Chart 7.3.3 SMF Utility Report File Program Control Flow 
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SERVICE LOGGING SUBFUNCTION 


The service logging subfunction records system 
maintenance-related information for use by the service 
representative. The information is recorded in 
#SERVLOG, a variable-length record, system file. 

Entries can be entered automatically by the 
configuration, IPL, task termination, and PTF apply/copy 
subfunctions, or manually, by the service representative, 
via the SERVLOG procedure. Service logging consists of 
service logging recording and service logging 

allocate /terminate subfunctions. 


Information recorded by the service logging function is 
displayed or printed by the dump service log utility 
(SFESRV), which is described under the Dump Utilities 
Subfunction. 


2-242 


Service Log Recording Transient 

The service logging recording transient is called by 
configuration, IPL (for overrides and system dump), task 
termination, and PTF apply/copy, to automatically record 
entries in the service log; service representatives can 
also make manual entries to the service log via the 
SERVLOG procedure. All callers invoke the recording 
transient via a transfer SVC instruction with RIB hex 39. 


The following service log recording processes are shown 
in Chart 7.4.1: 


1 Process user requests: 


« If logging session does not exist, call 
allocate /deallocate. 


e Assign buffer space. 
e Add new record to end of file. 


e Check service log for a wrap condition and 
update wrap table. 


e Return to caller. 


2  Allocate/deallocate service logging session. 


Caller via Transfer 
SVC Instruction with 
RIB Hex 39 


Service Log 
Recording 
Transient 
(HFERX) 


Service Log 
Allocate /Deallocate 
(Chart 7.4.2) 
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Chart 7.4.1 Service Log Recording Control Flow 
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Service Logging Allocate/Terminate 

Service logging allocate/terminate processes requests 
from service log recording or from termination. 
Requests are made via a transfer SVC instruction with a 
RIB of hex 3A. 


The following service logging allocate /terminate 
processes are shown in Chart 7.4.1: 


1 Process request to allocate logging session. 
2 Process request to terminate logging session. 


3 Allocate the logging session: 


Allocate service log file (FSERVLOG). 
e Build the service log control block. 
« Increment use count in file format 1. 


e Update current record pointers in service log 
control block. 


« Deallocate the format 1. 


Service Logging 
Recording Transient 
(Chart 7.4.1) 


Task Termination 


Service Logging 
Allocate / Terminate 
(#FEIN) 


Special Allocate 


$0530177-0 
Chart 7.4.2 Service Logging Allocate/Terminate Control Flow 
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Terminate the logging session: 
e Reallocate the service log file. 


e Update the current record pointers in the 
service log file. 


e Decrement use count in format 1. 
e Deallocate and remove the format 1. 
e Free service log control block. 


Return to caller. 
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TEST REQUEST SUBFUNCTION 3 Prompt for and execute appropriate printer 


verification test (menu option 2): 
The test request subfunction prompts for and executes 


various work station testing functions. These include ¢ Prompt for test. 
display/printer verification, configuration data 
confirmation, ERAP for work stations, keyboard data key ¢ Load the appropriate data areas module for 
verification, and link test. Test request is invoked by printer type: 
either the Test Request command key or by the — 5256 (#ST31). 
TESTREQ command. — 5224/5225 (#ST32). 
— 5224/5225 (#ST33). 
The following test request processes are shown in Chart — 5219 (#ST34). 
7.5: 


e Execute test. 
1 Prompt and route for work station verification type 


requested. « When canceled, return to #STO1. 
2 Prompt for and execute appropriate display 4 Alternately display configuration data for local and 
verification test (menu option 1): online remote work stations (menu option 3); when 


canceled, return to #STO1. 
« Display characteristics of a specified attribute. 


5 Load and run ERAP (menu option 4). 
e Display all displayable characters. 


e Display characteristics and/or function on any 
input field. 


e Test function keys. 


e Display characteristics of a specified color 
attribute. 


Initiator 


D Station 


isplay 
Verification Data 
ae Test Management 
Verification Verification (4ST02} 
Control Test 


(#STO3) 


Program 
(#STO1) 


Configuration 
Diagnostic Display 


Aids (#STO4) 
Mainline 
(Chart 7.1.0) 
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Chart 7.5 Test Request Control Flow 
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COMMUNICATIONS TEST SUBFUNCTION 3 Perform requested MLCA/ELCA operation: 


The communications test subfunction prompts for and ¢ BASIC communications diagnostic test. 
executes eight line communications attachment (ELCA), 

multiline communications attachment (MLCA), or single ¢ Link problem determination aids. 

line communications attachment (SLCA) tests. If MLCA 

or ELCA is configured, communications test prompts for ¢« Remote loopback test. 

the line number the test is to be run on. The 

communications test is invoked by the COMMTEST 4 Perform SLCA BASIC communications diagnostic 
procedure command. test processing. 

The following communications test processes are shown 5 Perform selected SLCA test processing: 

in Chart 7.6: 


e Link problem determination aids. 
1 Prompt and route for communications test functions 


requested: ¢ Remote loopback test. 
e ELCA. 6 Allocate/deallocate specified lines and load 
appropriate microcode. 
¢ MLCA. 
7 Print trace areas: 
e SLCA. 


¢ Print disk trace area 2. 
2 Set up for controller diagnostic test: 


e Print disk trace area 1. 
e Allocate all lines to prevent their use. 


e Set up error recovery block (ERB) for wrap. 


¢« Set error |OB and POST! command processor 
for error recovery (forces wrap). 
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Chart 7.6 Communications Test Control Flow 
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ONLINE PROBLEM DETERMINATION (OLPD) 
SUBFUNCTION 


The online problem determination (OLPD) subfunction 
presents information that is used by the customer in 
performing problem determination. OLPD is driven by 
OLPD control records; these records control the flow of 
OLPD, based on user responses to OLPD displays. For 
more information on OLPD control records, see Online 
Problem Determination Control File in the System Data 
Areas manual. 


OLPD consists of procedures, data areas, files, and 
programs. The remainder of this topic describes only 
the programs, and the procedures, data areas, and files 
directly applicable to those programs. 


The program portions of OLPD gather information for 
use by the customer in performing problem 
determination. 


The OLPD driver is evoked via the PROBLEM procedure 
from either the command displays or from a help menu. 
The local data area (LDA) is used by all OLPD modules 
to pass data to other modules and by the OLPD driver 
to control program flow. (For more information on 
OLPD use of the LDA, see Online Problem Determination 
Local Data Area in the System Data Areas manual.) All 
OLPD-executable code is written in assembler language 
and RPG II and is stored, with its associated data areas 
in #ONLPD, the online problem determination library. 
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The following online problem determination processes 
are shown in Chart 7.7: 


1 Determine online problem determination function 
required and route accordingly: 


¢ Set up LDA for function required. 
e Route control with return set in LDA. 


2 Determine communications adapter type attached 
and store 4 bytes of configuration data in LDA to be 
added to ‘next’ field of control record. 


3 Get line number for work station logical ID passed 
and build index for use in ‘next’ field of control 
record: store index in LDA. 


4 Check to determine if previously issued VARY OFF 
command was successful; build index to be added 
to ‘next’ field of control record and store in LDA. 


5 Check to determine if previously issued VARY ON 
command was successful; build index to be added 
to ‘next’ field of control record and store in LDA. 


6 Get work station communications configuration from 
WSWA and and place 4 bytes of data in LDA for 
use by #OPFCH. 


7 Using communications line configuration data placed 
in LDA by #OPFWA, build index for ‘next’ field of 
control record; store in LDA. 


8 Set up for control storage remote communications 
tests and route control. 


9 Based on logical work station ID passed, get and 
display work station address and work station port; 
if remote work station, get and display ID, address, 
and location description of associated controller (if 
any). Build index to be added to ‘next’ field of 
control record, based on information displayed, and 
store in LDA. 
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Chart 7.7 Online Problem Determination (OLPD) Control Flow 
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SSP System Utility Programs - $MMSP 
Function & 
¢ $MMST 
The SSP system utility programs function consists of 
programs that the user invokes through SSP-supplied « $PACK/ 
commands or procedures, command keys, function keys, $FREE 
or user-supplied OCL. Each set of load-run statements 
is accompanied by utility control statements that specify « $PNLM 
which utility options are requested and what user data is 
supplied as source for the utility. All system utilities run 
in user storage as user tasks. ¢ $POST 
The SSP system utility programs function includes the © = $PRxxx/ 
following utilities: $SRRxxx 
« $ARSP Auto response Chart 8.1 « $RENAM 
« $BICR Basic exchange and__ Chart 8.2.0 « $SETCF 
l-exchange 
¢ $BMENU — Build menu Chart 8.3 « $$SETCP 
¢ $BUILD Sector rebuild Chart 8.4 
- $SFGR 
- $COPY Disk copy/display Chart 8.5.0 
¢ $CPPE Procedure error Chart 8.6 « $UASC 
¢ $DCOPY Diagnostic diskette Chart 8.37 
copy « $UASF 
« $DDST Keysort Chart 8.7 
© $TINIT 
¢ $DELET File delete Chart 8.8 
« $TCOPY 
« $DUPRD Diskette copy Chart 8.9 
e $XREST 
- $FBLD File build Chart 8.10 
¢ $HELP Help Chart 8.11 « $$XSAVE 
¢ $HIST History file display Chart 8.12 
¢ #SINR 
¢ $IDSET SSP-ICF define ID Chart 8.13 
e = $INIT Diskette labeling Chart 8.14 « $TMSERV 
and initialization 
¢ $LABEL VTOC display Chart 8.15 ¢ #DSIN 
© $MAINT Library maintenance Chart 8.16.0 
« $MGBLD- Message build Chart 8.17 
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definition utility (IDDU) 


AUTO RESPONSE UTILITY ($ARSP) 


The auto response utility updates message load 
members in a disk library based on input read from a 
source member. The utility finds the requested message 
in the message load member, inserts the requested auto 
response value and severity level, and writes the 
updated message back to disk. The auto response utility 
is invoked by the RESPONSE procedure or equivalent 
OCL, control, and specification statements. 


The following auto response processes are shown in 
Chart 8.1: 


1 Perform the following, routing where necessary: 
e Process utility control statements. 
« Get source member from user or #LIBRARY. 


« Get specification statement from input source 
member. 


e Find specified message, insert auto response 
value, and write message back to disk. 


Initiator 


2 Syntax Checker 


Auto Response 
Utility 
(SARSP) 


Librarian Find 


9 SYSLOG 


Chart 8.1 Auto Response Utility Control Flow 


« Get next specification statement and repeat 
above process. 


e Issue error messages as required. 
« Terminate program. 
2 Read and syntax check utility control statements. 
3 Find requested user library. 
4 Find requested source member and get from library. 


5 Read specification statements from input source 
member. 


6 Find specified message member. 
7 Protect member while updating. 
8  Read/write disk. 

9 Issue requested error messages. 


10 Terminate. 


Find a Library 
Go Source Get 
4,5 GC 
Library Member 
Protect 
6 Control Storage 
8 


Termination 
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BASIC EXCHANGE AND I-EXCHANGE UTILITY The following basic exchange and I|-exchange utility 


($BICR) overview processes are shown in Chart 8.2.0: 

The basic exchange and |-exchange utility can convert 1. Read and check syntax of control statements. 
either a disk file to basic or |-exchange file on diskette 

or a basic or l-exchange diskette file to a sequential or 2 Get format 1 for diskette COPYIN file. 

indexed disk file. It can also add a basic or Il-exchange 

file to a sequential disk file or display all or part of a 3. If requested, display basic exchange or |-exchange 
diskette basic or l-exchange file on the SYSLIST device. diskette file. 

The basic exchange and |-exchange utility can be called 

by the TRANSFER procedure or by equivalent OCL 4 If requested, perform diskette-to-disk copy. 
statements. 


5  \|f requested, perform disk-to-diskette copy. 


Initiator 


Syntax Checker 


Active Format-1 
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and |-Exchange 
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Chart 8.2.0 Basic Exchange and I-Exchange Utility Overview Control Flow 
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The following basic exchange and |-exchange utility 
diskette-to-SYSLIST copy processes are shown in 
Chart 8.2.1: 

1 Perform basic exchange diskette to SYSLIST copy. 
2 Perform I-exchange diskette to SYSLIST copy. 

3 Find diskette file on magazine drive. 

4 Allocate COPYIN file and open diskette DTF. 


5 Read records. 


6 If records are within limits specified, print/display 
output to SYSLIST device. 


7 Issue any required messages. 


8 Close diskette file and terminate this job step. 


5 
Basic Exchange Basic Exchange 
1 Diskette-to-SYSLIST Diskette Data 
Copy Management 
(SBICDI) 4 
5 
Basic Exchange |- Exchange |- Exchange 
and |- Exchange 2.1 Diskette-to-SYSLIST Diskette Data 


Copy 
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Chart 8.2.1 Basic Exchange and I-Exchange Utility Diskette-to-SYSLIST Display Control Flow 
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The following basic exchange and I|-exchange utility 
diskette-to-disk copy processes are shown in Chart 
G22: 

1 Perform basic exchange diskette to disk copy. 
2 Perform |-exchange diskette to disk copy. 

3 Get format 1 for diskette COPYIN file. 


4 Find diskette file on magazine drive. 


5 Allocate diskette input file, disk output file, and 
open DTFEs. 


6 Read diskette file records. 
7 Write disk records. 
8 Issue any required messages. 


9 Close input and output files and terminate this job 


step. 
6 
| Basic Exchange 
Basic Exchange Diskette Data 
Diskette-to- Disk Management 
Copy 
(SBICIF) 
6 


l-Exchange 
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Chart 8.2.2 Basic Exchange and I-Exchange Utility Diskette-to-Disk Copy Control Flow 
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The following basic exchange and l-exchange utility 
disk-to-diskette copy processes are shown in Chart 
8.2.3: 

1 Perform disk to basic exchange diskette copy. 
2 Perform disk to l-exchange diskette copy. 


3 Get format 1 for disk COPYIN file. 


4 Allocate disk input file, diskette output file, and 
open DTFs. 


5 Find diskette file on magazine drive. 
6 Read disk file records. 

7 Write diskette file records. 

8 Issue any required messages. 


9 Close input and output files and terminate this job 
step. 
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Chart 8.2.3 Basic Exchange and I-Exchange Utility Disk-to-Diskette Copy Control Flow 
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BUILD MENU UTILITY ($BMENU) 2 Read and syntax check the utility control 


statements. 
The build menu utility creates the library members 
required to display a menu. The user calls the utility 3 Prepare the work file to build the screen format 
with the BLDMENU procedure or with appropriate OCL generator source records. 


and utility control statements. 
4 Build temporary screen format source records 


The following build menu utility processes are shown in reflecting the menu being built. Print the menu that 
Chart 8.3: was designed on the screen by the user. 
1 Do the following, routing control where necessary: 5 Build the menu. 


« Process utility control statements. 
e Set up the work file. 
e Build source records. 


e« Build the screen format generator main storage 
communications area. 


e Call the screen format generator utility to build 
required members for the menu. 
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2 Syntax Checker 
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Chart 8.3 Build Menu Utility Control Flow 
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SECTOR REBUILD UTILITY ($BUILD) 3 Load page heading messages. 


The sector rebuild utility allows the user to correct 4 Read verify all sectors on disk. If any possibly 
possibly erroneous disk data. This data can result when defective sectors are found, do the following, 

a disk |/O error occurs and the data recovery attempts remaining processes. 

were not successful. The user invokes the sector rebuild 

utility with the BUILD procedure or appropriate OCL. 5 Read VTOC format-1 records to determine if the 


sector is in a file. 
The following sector rebuild utility processes are shown 


in Chart 8.4: 6 On SYSLIST, list the sector ahead of the possibly 
defective one, the possibly defective sector, and the 
1 Issue printer forms change message to system sector following the possibly defective one. 
operator. 


7 Display the possibly defective sector to the 
2 Find and load $FEKEY or $FEIGC. operator, allowing for modification of the data. 
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Chart 8.4 Sector Rebuild Utility Control Flow 
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DISK COPY/DISPLAY UTILITY (SCOPY) 

The disk copy/display utility copies requested files 
between disk and disk, diskette, or tape. The utility 
copies a requested portion of a file between disk and 
disk or diskette. The utility also copies a requested file 
or portion of a file from disk, diskette, or tape to the 
SYSLIST device. If a file is defined in the network 
resource directory (NRD), the requested operation is 
done in record mode and the data is copied to or from 
the remote system. The utility is invoked by appropriate 
procedures or OCL and utility control statements. 


The following copy/display overview processes are 
shown in Chart 8.5.0: 


1 Read and check the syntax of utility control 
statements. 


2 If required, allocate printer or SYSLIST device. 
3 Issue any required messages. 


Determine type of copy required and route control 
accordingly: 


4 Process for record mode and remote file copy. 
5 Add disk file to existing diskette file. 

6 Process for disk-to-disk high-speed copy. 

7 Process for diskette-to-disk high-speed copy. 
8 Process for tape-to-disk high-speed copy. 

9 Process for disk-to-diskette high-speed copy. 


10 Process for disk-to-tape high-speed copy. 
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Chart 8.5.0 Disk Copy/Display Utility Overview Control Flow 
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Record Mode/Remote File Copy 

Record mode/remote file copy performs the copy by file 
record to allow analysis of individual records for any of 
the following purposes: 

e File reorganization 


e Display or printing of selected records 


e Record selection based on content, key value (for 
indexed files), or position in input data file 


¢ Remote file processing directly or indirectly through 
distributed data management (DDM) 


The following record mode/remote file copy input 
initialization processes are shown in Chart 8.5.1.1: 


1 Check if remote system supports DDM remote file 
transfer operations. 


2 Allocate diskette drive and search for specific 
diskette. 


3 Allocate input disk, diskette, or tape file. 

4 Open input diskette file. 

5 Get additional main storage for tape cartridge. 

6 Lock data dictionary and get file definition level. 
7 ~~ Get data dictionary information from disk VTOC. 
8 Issue error messages. 

9 Close input diskette file (depending on error). 

10 Terminate this job step (depending on error). 


11 Load and route control to the process for record 
mode/remote file copy output initialization. 
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Chart 8.5.1.1 Record Mode/Remote File Copy Input Initialization Control Flow 
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The following record mode/remote file copy output 
initialization processes are shown in Chart 8.5.1.2: 


1 Special allocate the output disk file. 
2 Write output disk file format 1 to VTOC. 
3 Close data dictionary. 


4 Allocate diskette drive and search for specific 
diskette. 


5 Allocate output diskette file. 
6 Open output diskette file. 
7 Get data dictionary information from disk VTOC. 


8 Issue error messages through SYSLOG or the DDM 
remote message handler. 


9 Close input or output diskette file (depending on 
error). 


10 Terminate this job step (depending on error). 


11 Open input and/or output disk file(s); open input 
tape file. 


12 Determine the type of copy and route control 
accordingly: 


e Process for record mode/remote file copy with 
|/O interface through disk data management. 


e Process for remote file copy through direct |/O 


interface with distributed data management 
(DDM). 
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Chart 8.5.1.2 Record Mode/Remote File Copy Output Initialization Control Flow 
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The following record mode/remote file copy |/O 
interface through disk data management processes are 
shown in Chart 8.5.1.3: 


1 Get and/or put records from/to local/remote disk 
file. 


2 Get or put records from/to diskette file. 

3 Get records from tape file. 

4 Process a record for printing, if requested. 

5 On first call to $COPRT, get the printer image. 
6 Print records. 


7 Process a record for display to the CRT, if 
requested. 


8 Display records to the CRT. 


9 Process records from $COGET and direct $COGET 
in performing WSU-required processing. 


10 Determine if record should be included or omitted 
from output. 


11 Issue error messages through SYSLOG or the DDM 
remote message handler. 


12 Close the disk, diskette, or tape file(s). 
13 Terminate this job step. 
Note: When processing a remote disk file, the |/O 


processes (allocate, open, get, put, close) interface with 
DDM to perform the operations on the remote system. 
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Chart 8.5.1.3 Record Mode/Remote File Copy !/O Interface Through Disk Data Management Control Flow 


Section 2: SSP System Utility Programs Function 8 | 2-265 
This document contains restricted materials of IBM. LY21-0590-4 


©Copyright IBM Corp. 1983, 1984, 1985, 1986 


The following remote file copy direct I/O interface with 
distributed data management (DDM) processes are 
shown in Chart 8.5.1.4: 

1 Open DDM remote file transfer operation(s). 


2 Get or put records directly from/to remote disk file. 


3 Get or put records from/to local disk file or 
indirectly from/to remote disk file. 


4 Get or put records from/to diskette file. 

5 Process a record for printing, if requested. 
6 On first call to $COPRT, get the print image. 
7 Print records. 


8 Process a record for display to the CRT, if 
requested. 


9 Display records to the CRT. 


10 Determine if record should be included or omitted 
from output. 


11 Issue error messages through SYSLOG or the DDM 
remote message handler. 


12 Close DDM remote file transfer operations. 
13 Close the disk or diskette file. 
14 Terminate this job step. 


Note: When processing a remote disk file indirectly 
through disk data management, the |/O processes 
(allocate, open, get, put, close) interface with DDM to 
perform the operations on the remote system. When 
processing a remote disk file directly through DDM 
remote file transfer operations (except for file allocation), 
$COPY directly interfaces with DDM to perform the 
operations on the remote system. 
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Chart 8.5.1.4 Remote File Copy Direct I/O Interface with DDM Control Flow 
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Add Disk File to Diskette File 3 Open disk and diskette files. 


The add disk file to diskette file subfunction adds an 4 Get sectors of data from disk file. 

existing disk file to an existing diskette file. Control is 

routed to this subfunction from disk copy/display 5 Put sectors of data to diskette file. 

mainline, based on requests received from the user. (Repeat processes 4 and 5 until all the data has 


been copied to diskette.) 
The following add disk file to diskette file processes are 


shown in Chart 8.5.2: 6 Issue error messages if necessary. 
1 Allocate diskette drive and search for specific 7 Close disk and diskette files. 
diskette. 


8 Terminate this job step. 
2 Allocate disk and diskette files. 
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Chart 8.5.2 Add Disk File to Diskette File Control Flow 
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High-Speed Disk File to Disk File Copy 


The high-speed disk file to disk file copy subfunction 
copies one disk file to another. Control is routed to this 
subfunction from disk copy/display mainline, based on 
requests received from the user. High-speed disk file to 
disk file copy copies multiples of 256-byte sectors 
without regard to individual records; it interfaces directly 
to control storage disk |OS, without going through disk 
data management. 


File 

Copy/ Display 
Mainline 
(Chart 8.5.0) 


Control Storage 


High-Speed, 3 
Disk-to- Disk 
Copy 
(SCOZFF) 


Termination 


Chart 8.5.3 High-Speed Disk File to Disk File Copy Control Flow 


The following high-speed disk file to disk file copy 
processes are shown in Chart 8.5.3: 


1 Allocate input disk file. 

2 Special allocate output disk file. 

3 Copy sectors of data from input to output file. 

4 If indexed output file, extract keys and build index. 
5 Issue error messages if necessary. 


6 Terminate this job step. 
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High-Speed Diskette/Tape File to Disk File Copy 3 Normal allocate input diskette drive, tape drive, and 
diskette data compression control storage 


The high-speed diskette/tape file to disk file copy microcode. 

subfunction copies diskette or tape files to disk in sector 

mode. Control is routed to this subfunction from disk 4 Special allocate output disk file. 
copy/display mainline, based on requests received from 

the user. High-speed diskette/tape file to disk file copy 5 Copy sectors of data from diskette to disk. 
is used to restore a diskette/tape file(s) to disk; it uses 

disk and diskette sector data managements or the data 6 Copy sectors of data from tape to disk. 
storage controller to copy multiples of 256-byte sectors 

without regard to individual records. It also acquires the 7 ~~ Create alternative index file(s) if required. 


necessary work space for diskette data compression. 


8 Extract keys to build index portion of indexed files. 
The following high-speed diskette/tape file to disk file 


copy processes are shown in Chart 8.5.4: 9  Deallocate disk file if this is a multiple file restore 
operation (repeat processes 2 through 8 until all 

1 Allocate and prepare multiple diskette drive slots. files are restored). 

2 Prepare single slot diskette drive. 10 Issue any required error messages. 


11 Deallocate the diskette data compression control 
storage microcode. 


12 Terminate this job step. 
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Chart 8.5.4 High-Speed Diskette/Tape File to Disk File Copy Control Flow 


Section 2: SSP System Utility Programs Function 8 | 2-271 
This document contains restricted materials of IBM. LY21-0590-4 
©Copyright IBM Corp. 1983, 1984, 1985, 1986 


High-Speed Disk File to Diskette/Tape File Copy 4 If diskette copy, prepare the diskette if the system 


only has one diskette slot. 
The high-speed disk file to diskette/tape file copy 


subfunction copies disk file(s) to diskette or tape in 5 Normal allocate output diskette drive, tape drive, 
sector mode. Control is routed to this subfunction from and diskette data compression control storage 

disk copy/display mainline, based on requests received microcode. 

from the user. High-speed disk file to diskette/tape file 

copy is used to save a disk file(s) on diskette or tape; it 6 If diskette copy, copy sectors of data from disk to 
uses disk and diskette sector managements or the data diskette. 

storage controller to copy multiples of 256-byte sectors 

without regard to individual records. It also acquires the 7 If tape copy, copy sectors of data from disk to tape. 


necessary work space for diskette data compression. 
8 Deallocate the disk file if this is a multiple file save. 


The following high-speed disk file to diskette/tape file (Repeat processes 1 through 8 until all specified 
copy processes are shown in Chart 8.5.5: files are saved.) 
1 If SAVE ALL was specified, find the first disk file to 9 Issue any required error messages. 

save. 


10 Deallocate the diskette data compression control 
2 Allocate the disk file. storage microcode. 


3 If diskette copy, search for the specified diskette to 11 Terminate this job step. 
start the save. 
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Chart 8.5.5 High-Speed Disk File to Diskette File Sectorized Copy Control Flow 


Section 2: SSP System Utility Programs Function 6 | 2-273 
This document contains restricted materials of IBM. LY21-0590-4 
©Copyright IBM Corp. 1983, 1984, 1985, 1986 


PROCEDURE ERROR UTILITY ($CPPE) 


The procedure error utility allows |BM-supplied 
procedures and user-written procedures to issue error 
messages. IBM-supplied procedures invoke the error 
utility with the #ERR system procedure, and 
user-written procedures invoke the utility with the ERR 
procedure. 


The following procedure error utility processes are 
shown in Chart 8.6: 


1 Read and syntax check utility control statements. 

2 Issue error message requested. 

3. If option 3, D, or H was not taken (in which case 
SYSLOG terminated without returning to $CPPE), 


return option selected to calling procedure. 


4 Terminate this job step. 
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Chart 8.6 Procedure Error Utility Control Flow 
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KEYSORT UTILITY ($DDST) 3 Allocate the specified file. 


The keysort utility sorts the index entries of a specified 4 Open the file. 
indexed file or alternative index. The utility is invoked by 

the KEYSORT system procedure or by equivalent OCL. 5  Keysort the file. 
The following keysort utility processes are shown in 6 Deallocate the file. 
Chart 8.7: 


7 Close the file. 
1 Process the keysort request, routing control where 


necessary. 8 Issue any required messages. 


2 Syntax check utility control statements. 9 Terminate this job step. 


Initiator 


Syntax Checker 


Special Allocate 


4 Open 
5 
Keysort Keysort 
($SDDST) Deallocate 
7 Close 
8 


SYSLOG 


Termination 


$0590233-0 


Chart 8.7 Keysort Utility Control Flow 
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FILE/LIBRARY/FOLDER DELETE UTILITY (SDELET) 


The file/library/folder delete utility frees space on a disk 
or diskette for use by new files, libraries, or folders. lf 
the file is defined in the network resource directory 
(NRD), the file is deleted from the remote system. The 
user Calls the file/library delete utility with the DELETE 
procedure or appropriate OCL and utility control 
statements. 


The following file/library delete utility processes are 
shown in Chart 8.8: 


1 Read and syntax check utility control statements. 
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Chart 8.8 File/Library/Folder Delete Utility Control Flow 
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Use the VTOC to find format 1 for file, library, or 
folder to be deleted. If request is for file or folder, 
special allocate it. If it is for library, call find a 
library. Deallocate the file, library, or folder, 
specifying to delete. If ERASE-YES, deallocate 
specify to write zeroes over the data. If the file is 
on a remote system, the special allocate and 
deallocate interacts with DDM to perform the delete 
operation. 


Delete the file from the diskette. For SCRATCH, set 
the diskette file expiration date to the current date; 
for REMOVE, remove the file entry from the VTOC; 
for ERASE, remove the file entry from the VTOC 
and zero the data. 


Process required messages to the operator. 
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DISKETTE COPY UTILITY ($DUPRD) 

The diskette copy utility copies the files from one or 
more diskettes onto one or more other diskettes. It can 
be used to create an extra copy of a diskette file or to 
gather all unused space on one diskette into a single 
free area on another diskette. The copy-to and 
copy-from diskettes must be of the same format. 

The diskette copy utility is invoked by the COPYI1 
procedure or appropriate OCL and utility control 


statements. 


The following diskette copy utility processes are shown 
in Chart 8.9: 


1 Determine functions requested, then process or 
route for the following: 


« Process utility control statements. 
e Allocate required resources. 
¢« Load disk and diskette data managements. 
e Load and call appropriate diskette copy module. 
2 Syntax check utility control statements and put 
utility control language data into copy utility 
communications area. 
3 Allocate diskette device. 


4 Read specific/all format 1's into storage. 


5 Determine single file copy functions requested, then 
process or route for the following: 


e Read and convert header information. 
¢ Copy diskette file to a disk scratch file. 
e Fetch and load single file copy output module. 


° Process read diskette read error. 


2-278 


This document contains restricted materials of IBM. LY21-0590-4 
©Copyright IBM Corp. 1983, 1984, 1985, 1986 


10 


11 


12 


13 


14 


15 


Read and convert header information into diskette 
format 1. 


Read diskette file from the diskette to disk. 
Read diskette file from disk and write to diskette. 


If necessary, display error sector on diskette and 
prompt for corrections. 


Determine diskette or magazine copy functions 
requested, then process or route for the following: 


e Read and convert header information. 

« Copy diskette files to disk scratch files. 

¢« Fetch and load single file copy output module. 
e« Process read diskette read error. 


Read header information for each file and create a 
format 1 for each file on a disk scratch file. 


Read each diskette file from disk scratch files and 
write to diskette. 


Close diskette and disk files. 
Issue any required messages. 


Terminate this job step. 
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Chart 8.9 Diskette Copy Utility Control Flow 
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FILE BUILD UTILITY ($FBLD) 


The file build utility allows the user to allocate a disk file 
either on the local system or on a remote system 
without supplying data records (null file). The utility can 
also be used to create a new alternative index file, with 
the index based on data in an existing physical file. If the 
physical file is on the local system, the alternative index 
will be created on the local system. If the physical file is 
on a remote system, the alternative index will be created 
on the remote system. 


The user calls the file build utility with the BLDFILE or 
BLDINDEX procedures or with the equivalent OCL and 
utility control statements. 

Note: When creating a remote file, the allocate and 
deallocate interacts with DDM to perform the operations 


on the remote system. 


The following file build utility processes are shown in 
Chart 8.10: 


1 Read and syntax check utility control statements. 


2 Allocate a new null data file with the characteristics 
specified in the utility control statements. 


3  Deallocate the null data file allocated in the process 
reference above. 


4 Allocate the physical file that the alternative index 
file is based on. 
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Perform the following processes to create an 
alternative index file. 


If the physical file is on the remote system, the 
following processes are performed: 


° Check if the user is authorized to create an 
alternative index file over it. 


¢ Give control to the DDM Source Manager to 
create the alternative index on the remote 


system. 


If the physical file is on the local system, the 
following processes are performed: 


e Enqueue an interlock on the physical file. 
e Allocate space for the alternative index file. 


e Extract the alternative keys from the data in the 
physical file. 


¢  Deallocate the new alternative index file (the 
keys in the file may be sorted). 


e Read the highest key in the alternative index file 
and build a high-key-bucket. 


e Indicate in the VTOC entry for the physical file 
that the file has an alternative index based on It. 


e Dequeue the interlock on the physical file. 


Deallocate the physical file that the alternative index 
is based on. 


Issue any required messages. 


Terminate this job step. 
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Chart 8.10 File Build Utility Control Flow 
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HELP UTILITY ($HELP) The following help utility processes are shown in Chart 


8.11: 
The help utility assists a user in running |BM-supplied 
procedures without referring to hard copy information on 1 ‘Initialize for help support requested: 
the detail parameters required. The utility guides the 
user by prompting for procedure parameters and e Determine where call was from. 
displays information about OCL and procedure control 
expression (PCE) statements. The help utility displays ¢ Initialize task work area (TWA). 


three types of screens: 


e Initialize procedure parameter save area (PPSA). 
¢ Screens that prompt for procedure parameters. 


2 Get appropriate help table module(s) based on user 
« Screens that list OCL or PCE statements from which option specified. 
a specific statement can be selected. 


3 Set up for requested help display. 
« Screens that provide information on specific OCL or 


PCE statements. 4 Put help displays; get responses. 
The help utility works in conjunction with command 5 Issue any required messages. 
processor help facilities to respond to user requests. If 
help cannot perform a user-requested function from 6 Issue a job queue request or check for a valid 
within a procedure, it passes control to command command when the user help request is not in the 
processor help via the command processor interface help utility's list of procedures. 
(#CPIN). Command processor help calls the help utility 
(SHELP) when it cannot perform the function requested 7 Put/get PPSA. 


by the user from the keyboard. 


8 Terminate this job step. 
The user can invoke the help utility in any of the 


following ways: 


e Pressing the Help key when a procedure name is 
entered on the input line. 


e Entering ‘HELP XXXXXXXX’, where XXXXXXXX is a 
system procedure name. 


¢ Selecting an option from the command processor 
help menu. 


¢« Selecting the H option from a message displayed by 
a system procedure or program. 


In all of the above cases, the command processor 
invokes the help utility via the initiator. 
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From a Procedure via 
the Command Processor 


From Command Processor 
Help 1/0 


1 Initiator Help Control 
Command Processor 
(#CHLP) 


Help Table Modules 


Help 
Utility 


(SHELP) 


Procedure Control Expression 
Lists and Statements 


5 SYSLOG 


PPSA Interface 
(#CILP) 


Termination 


Chart 8.11 Help Utility Control Flow 
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HISTORY FILE DISPLAY UTILITY ($HIST) 

The history file display utility allows the user to display 
the system history file (via the SYSLIST device), erase 
the system history file, copy the system history file to a 
user file, or scroll either the history file or a previously 


copied user file. 


The following history file display utility processes are 
shown in Chart 8.12: 


1 Read and syntax check the utility control 
statements. 


2 Display the system history file. 
3 Display a user file. 


4 Copy the system history file to a user file, if 
requested. 


5 Scroll the system history file. 
6 Scroll a user file. 


7 Read/write disk, as required. 


Syntax Checker 


2,3 SYSLIST 


History File 6 | 
Display Utility 

History File 
Scroll Display 
(SHSSCRL) 


(SHIST) 


Control Storage 


$0590238-0 
Chart 8.12 History File Display Utility Control Flow 
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SSP-ICF DEFINE ID UTILITY ($IDSET) 3 Perform user-requested file maintenance: 


The SSP-ICF define ID utility is used to display, update, « Allocate file. 

or delete remote ID file entries for a switched 

communications line that uses the SSP-ICF BSCEL « Write file to storage. 

subsystem fi. The switched line ID file (#IBSRID) 

cannot be altered when the BSCEL subsystem is ¢« Display, update, or delete according to user 
enabled. The define ID utility is invoked by the DEFINEID request. 


system procedure or equivalent OCL. 


e If update, write file to disk. 
The following define ID utility processes are shown in 


Chart 8.13: « Deallocate file. 


1 Route for syntax checking Route for system file 4 Issue any required messages. 
maintenance: 


5 Terminate this job step. 
« Set XR1 to indicate user request (display, 


update, or delete). 
e Load and branch to $IDSM. 


2 Syntax check utility control statements. 


Work Station 
Data Management 


Initiator Disk Data 
Management 


SSP-ICF 


Syntax Checker Define ID 


Gg 
3 


SSP-ICF Define 
ID Utility SYSLOG 


Special Allocate 


(S$IDSM) 


Deallocate 


(S$IDSET) 


Termination 
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Chart 8.13 ICF Define ID Utility Control Flow 
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DISKETTE LABELING AND INITIALIZATION UTILITY 
(SINIT) 


The diskette labeling and initialization utility formats a 
diskette, renames a diskette, or deletes files from a 
diskette. While formatting a diskette, the utility assigns 
alternative tracks for tracks found to be defective. A 
maximum of two alternative tracks are allowed; if more 
than two defective tracks are found, the diskette is 
considered unusable. 


The following diskette labeling and initialization utility 
processes are shown in Chart 8.14: 


1 Read and syntax check utility control statements. 
2 Allocate diskette drive. 


3 Perform requested function. 


Syntax Checker 


Diskette Labeling 6 | 
and Initialization 


Utility 
(SINIT) Allocate 


$0590240-1 


Chart 8.14 Diskette Labeling and Initialization Utility Control Flow 
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VTOC DISPLAY UTILITY (SLABEL) 


The VTOC display utility displays or prints disk/diskette 
VTOC information, tape label information, network 
resource directory (NRD) information, and remote system 
VTOC information. The user calls VTOC display with the 
CATALOG procedure or appropriate OCL and utility 
control statements. 


The following VTOC display utility processes are shown 
in Chart 8.15: 


1 Read and syntax check utility control statements. 


2 If request is for the entire disk VTOC, sort VITOC 
entries for display: 


3 Allocate a work file for VTOC entry sort. 
4 Build entries for work file using VTOC and NRD. 
5 Issue any required messages. 


6 If request is for a specific disk file, format and 
display disk VTOC entires. If file is on a remote 
system, format and display NRD entry. 

7 Format and display disk VTOC entries: 

8 Get headings for VTOC display. 


9 Get VTOC entries from work file. 


10 Read VTOC entries for display data. 


11 Display or print VTOC information. 

12 Deallocate work file. 

13 If DDM is installed, display or print NRD entries. 
14 Issue any required messages. 


15 


16 


17 


18 


19 


20 


21 


22 


23 


24 


25 


26 


27 


28 


29 


30 


31 


32 


33 


34 
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If request is for diskette VTOC, format VTOC entries 
for display: 


Allocate diskette drive. 
Read diskette VIOC entries. 
Read diskette track label for VTOC information. 
Get headings for VTOC display. 
Display or print VTOC information. 
Issue any required messages. 
If request is for tape, allocate the tape drive: 
If request is for tape sort by name: 


Allocate a work file for the tape label sort 
entries. 


Read the tape labels. 
Read/write entries to/from the work file. 
Deallocate unused work file. 


If request is for a specific tape file or if request 
is for a sort by location: 


Format and display tape entries: 
Get headings for tape label display. 


lf a work file was used, read the entries 
from the work file. 


If a work file was not used, read the tape 
labels. 


lf a work file exists, deallocate it. 


Display or print the tape label information. 
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Chart 8.15 (Part 1 of 2) VTOC Display Utility Control Flow 
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(continued) 


(continued) Message Retrieve 


(continued) 


Display Diskette 
VTOC Routine 
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SYSLOG 
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Chart 8.15 (Part 2 of 2) VTOC Display Utility Control Flow 
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LIBRARY MAINTENANCE UTILITY (S$MAINT) 


The library maintenance utility can be used for any of 
the following: 


¢ Copy specified members to and from libraries and 
files. 


e Create libraries and reallocate them according to 
user size specifications. 


e Save and restore entire libraries to and from 
diskette and tape. 


e Add or delete members from libraries. 
¢« Display library information. 
e Compress unused space within a library. 


e Change specified member's name, subtype, and 
reference number. 


The library maintenance utility is invoked by several 
different system procedures and it can also be evoked 


by equivalent OCL and utility control statements. 


The following library maintenance utility mainline 
processes are shown in Chart 8.16.0: 


1 Read and syntax check utility control statements. 


2 Process request to save a library from disk to 
diskette. 


3 Process request to restore a library from diskette to 
disk. 


4 Issue any required messages. 
5 Process request to reallocate a library so members 
in an extent can be placed in library. If required, 


process new directory and and library sizes. 


6 Process request to allocate a user library or change 
size (or directory size) of a user library. 
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10 


11 


12 


13 


14 


15 


16 


17 


18 


19 


20 


If request involves library transfer, find the library. 
Process request to compact a library. 


Process request to delete member or members from 
a library. 


Process request to display library and library 
member information. 


Process request to copy or add source or procedure 
members from library to file in record mode. 


Process request to copy members from library to 
file in sector mode. 


Process request to copy members from one library 
to another. 


Process request to display members from a file in 
record mode. 


Process request to copy members from file to 
library in record mode. 


Process request to display library and library 
member information from a file. 


Process request to copy members from file to 
library in sector mode. 


Process request to copy records from reader to a 
library member. 


Process request to change a member's name, 
subtype, and reference number. 


When all utility control statements have been 
processed, terminate this job step. 
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Chart 8.16.0 Library Maintenance Utility Mainline Control Flow 
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Save a Library 7 ‘If library is #LIBRARY, copy heading messages to 
the bootstrap file. If heading messages are not 


Save a library processes the SAVELIBR procedure found, issue an error message and return to 
command, saving all members from a library to a mainline. 
diskette file. 
8 Fora save to diskette, copy the LCS, compressed 
The following save a library processes are shown in directory, and compressed members to the library 
Chart 8.16.1: diskette file. 
1 Find the specified library. 9 If library is #LIBRARY, copy the IPL bootstrap 
(#MSNIP), the security module (@PRLD) and the 
2 Read the library control sector (LCS). reload screen formats (##FLOD) to diskette or tape; 
if any of these modules are not found, issue an 
3 Compact the library directory. error message and return to mainline. 
4 Allocate the library diskette or tape DTF; if library is 10 For a save to tape, copy library to tape. 


#LIBRARY, also allocate a bootstrap DTF. 


11 Whenever possible, use streaming mode. 
5 Open the diskette or tape DTF(s). 


12 Issue any required messages. 
6 For a save to diskette, read the library directory and 


build a matrix table (1 bit for each sector allocated). 13 Close the diskette or tape DTF(s) and return to 
mainline. 
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Chart 8.16.1 Save a Library Control Flow 
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Restore a Library 5 Read the library control sector (LCS) from diskette 


or tape. 
Restore a library processes the RESTLIBR procedure 
command, restoring to disk library members that were 6 _—siIf library already exists, issue message. If user 
saved with the SAVELIBR procedure. continues, allocate scratch file. 
The following restore a library processes are shown in 7 ~~ ‘(If library does not exist, allocate a new disk file. 


Chart 8.16.2.1. 


8 Issue any required messages. 
Note: If restoring a library via the RESTLIBR procedure, 


the #IPLPROC procedure will be called and processes 1 9 Write the diskette or tape LCS to disk. 

through 14 will not occur. Tape or diskette may be 

used. If restoring a library via utility control statements, 10 Read the rest of the diskette or tape library. 

tape may not be used. Processes 1 through 14 will 

occur. 11 Write the diskette or tape library to disk. 

1 Ensure that library is not in use; if library is 12 Close the diskette or tape DTF. 
#LIBRARY, ensure that system is dedicated; if 
library in use or system is not dedicated, issue 13 If library being restored already exists, point existing 
message. F1 to scratch file and point scratch file F1 to 


existing library. 
2 Find the specified library on disk. 
14 \|f IBM-supplied members were copied, set OXREF 
3 Allocate and open the diskette or tape library DTF. indicator on (so that cross-reference resolver G will 
be run later), and return to mainline. 
4 If library is #LIBRARY, restore it. 
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Chart 8.16.2.1 Restore a Library Control Flow 
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The following restore #LIBRARY processes are shown in 4 Write updated format 1 to disk. 
Chart 8.16.2.2. 

5 Read the configuration record from disk. 
Note: If restoring #LIBRARY via the RESTLIBR 


procedure, the #IPLPROC procedure will be called, and 6 Write updated configuration record to disk. 
processes 1 through 11 will not occur. If restoring 
#LIBRARY via utility control statements, processes 1 7 Copy the bootstrap file (#MSNIP) to disk. 


through 11 will occur. 
8 Read the library on diskette. 
1 Read bootstrap file messages and display formats 


from diskette. 9 Write the library to disk. 
2 Read the disk format 1 for #LIBRARY. 10 Resolve module disk relocations. 
3 Suspend the command processor. 11 Terminate this job step. 
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(Chart 8.16.2.1) 
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Chart 8.16.2.2 Restore #LIBRARY Control Flow 
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Library Condense 


Library condense removes gaps in the member space of 
the requested library. It is evoked by the CONDENSE 
procedure command, via library maintenance mainline. 


The following library condense processes are shown in 
Chart 8.16.3: 
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Find the specified library. 
If the library is in use or if the specified library is 
#LIBRARY and the system is not dedicated, issue 


message. 


If the specified library is #LIBRARY, suspend the 
command processor. 


Read the library control sector (LCS). 
Compact the library directory. 


Read the directory and build a matrix table (one 
entry for each library member sector). 


10 


11 


12 


13 


14 


15 


Process the matrix table, moving the members and 
building the hole table. 


Update and write the LCS. 


If there is now enough room, move the extent into 
the main library. 


If there is still not enough room to move the extent, 
issue a message. 


Update message member addresses in the JCB and 
update the menu member pointer in the JCB. 


Update the procedure parameter save area (PPSA), 
using hole table data. 


Update format index and WTG tables. 


If another pass is required, load $MARCK again; 
otherwise: 


Return to mainline. 
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Library-to-Print Copy—Sector Mode 


The library-to-print copy—sector mode routine displays 
the status and directory information of a user library or 
of the system library. It also displays members by 
name, type, or subtype. It is evoked by the LISTLIBR 
procedure command, via library maintenance mainline. 


The following save a library-to-print copy—sector mode 
processes are shown in Chart 8.16.4: 


1 Find the specified library. 


2 Read the configuration record for the chain image to 
see which characters are displayable. 


3 Retrieve all headings for the report. 


Library Maintenance Find a Library 
Utility Mainline Gi 
(Chart 8.16.0) 


Get Chain Image 


(#CSBT) 


Library-to-Print 
Mainline 
(SMADSP) 


Compact a Library 
(SMACMP) 


Chart 8.16.4 Library-to-Print Copy—Sector Mode Control Flow 
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4 Print necessary headings. 


5 Read the library control sector (LCS) to get status 
information on the specified library. 


6 If necessary, compact the library directory. 
7 ‘Print all specified status and directory information. 


8 Find the specified directory entries for printing 
members. 


9 Read the member's directory entries into the buffer. 


10 Print the requested information. 


Message Retrieve 


Control Storage 


SYSLIST 


Find Directory 
Entries 
(SMALFN) 


Source Library Get 
(4MASYL) 
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Library-to-File Copy or Add—Record Mode 

The library-to-file copy or add—record mode routine 
copies or adds source and/or procedure members from 
the library to a file in record mode. It is evoked by the 
FROMLIBR procedure command via library maintenance 


mainline. 


The following library-to-file copy or add—record mode 
processes are shown in Chart 8.16.5: 


1 Determine the device type of the output file. Load 
disk, diskette, or tape data management. 


2 Open the output file. 

3 Find the library member to be copied. 

4 Build the copy control statement. 

5 Write the copy control statement to the file. 
6 Get library member records. 

7 Write records to file. 


8 When all requested members are copied, close 
output file and return to mainline. 


Library Maintenance 


Utility Mainline 
(Chart 8.16.0) 
14 3 Open 
36 Library Get 
Library-to-File : 6 Disk, Diskette, or Tape 
Copy--Record Data Management 
Mode 
(SMARTF) 4) 
8 Close 
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Chart 8.16.5 Library-to-File Copy or Add—Record Mode Control Flow 


Section 2: SSP System Utility Programs Function 8 2-301 
This document contains restricted materials of IBM. LY21-O590-4 
©Copyright IBM Corp. 1983, 7984, 1985, 1986 


Library-to-File Copy—Sector Mode 3 Find the directory entries to be copied. 


The library-to-file copy—sector mode routine copies 4 Open the library and copy the member(s) from the 
specified members from a library to a disk, diskette, or library. 

tape file. This routine is evoked by the FROMLIBR 

command procedure via library maintenance mainline. 5 If applicable, copy to disk. 

The following library-to-file copy—sector mode 6 If applicable, copy to diskette. 


processes are shown in Chart 8.16.6: 


7 ‘If applicable, copy to tape. 
1 Find the specified library. 


8 Issue any required messages. 


2 Open the input file. 


9 Close the input file and return to mainline. 


Library Maintenance Find a Library 
Utility Mainline G 
(Chart 8.16.0) 
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Chart 8.16.6 Library-to-File Copy—-Sector Mode Control Flow 


2-302 
This document contains restricted materials of IBM. LY21-0590-4 
©Copyright IBM Corp. 1983, 1984, 1985, 1986 


Library-to-Library Copy—Sector Mode 3. If the copy-to library is #LIBRARY and the member 
being copied is an IBM-supplied member, ensure 


The library-to-library copy—sector mode routine copies system is dedicated; if system is not dedicated, 
specified members from one library to another. It also terminate this job step. 

copies and renames from one library to another or 

within the same library. Library-to-library copy is 4 Issue any required messages. 

evoked by the LIBRLIBR procedure command via library 

maintenance mainline. 5 Open the specified libraries. 

The following library-to-library copy—sector mode 6 Read the library control sector (LCS). 


processes are shown in Chart 8.16.7: 


7 Copy the specified members to the buffer, then to 


1 Find the specified library. the specified library. 
2 ~ Find the directory entries of the member to be 8 Close the libraries. 
copied. 


9 Update the directory entries. 


10 Write the LCS and return to mainline. 


Library Maintenance Find a Library 
Utility Mainline 6 | 
(Chart 8.16.0) 
; 
3 Termination 
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Library File-to-Print Copy—Record Mode 3 Print headings. 


The library file-to-print copy—record mode routine lists 4 If input from disk, read record from input file. 
the member type and name of all members in a record 

mode file. Library file-to-print copy is evoked by the 5 If input from diskette, read record from input file. 
LISTFILE procedure command via library maintenance 

mainline. 6 If input from tape, read record from input file. 
The following library file-to-print copy—record mode 7 Check for valid copy control statement. 


processes are shown in Chart 8.16.8: 


8 Print type and name from copy control statement. 
1 Get headings and current date and time. 


9 At end of file, close input file and return to mainline. 
2 Open the input file. 


Library Maintenance 
Utility Mainline 
(Chart 8.16.0) 
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Chart 8.16.8 Library File-to-Print Copy—Record Mode Control Flow 
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File-to-Library Copy—Record Mode 3 If input file is from disk, get copy control statement; 


check syntax and save attributes. 
The file-to-library copy—record mode routine copies 


source and procedure members from a disk file or a 4 If input file is from diskette, get copy control 
tape, or it copies a basic exchange diskette file directly statement; check syntax and save attributes. 
to a library. This routine is evoked by the TOLIBR 

procedure command via library maintenance mainline. 5 If input file is from tape, get copy control 


statement; check syntax and save attributes. 
The following file-to-library copy—record mode 


processes are shown in Chart 8.16.9: 6 Open the library for new member. 
1 Determine the type of input file device. 7 If input file is from disk, get record. 
2 Open the input file. 8 If input file is from diskette, get record. 


9 If input file is from tape, get record. 
10 Copy record to library. 


11 At end of file, close input file and return to mainline. 
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Utility Mainline 
(Chart 8.16.0) 
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Chart 8.16.9 File-to-Library Copy—Record Mode Control Flow 
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Library File-to-Print Copy—Sector Mode 

The library file-to-print copy—sector mode routine 
displays directory information for a disk, diskette, or 
tape file for files created by the FROMLIBR and 
SAVELIBR procedures. This routine is evoked by the 
LISTFILE procedure command via library maintenance 
mainline. 


The following file-to-print copy—sector mode processes 
are shown in Chart 8.16.10: 


1 Open the input file. 

2 Retrieve all headings for the report. 

3 Print the headings. 

4 If input file is from disk, read to fill buffer. 

5 If input file is from diskette, read to fill buffer. 
6 If input file is from tape, read to fill buffer. 


7 At end of file, close input file and return to mainline. 


Library Maintenance 
Utility Mainline 
(Chart 8.16.0) 


1 Open 


Message Retrieve 


3 SYSLIST 
Library File-to-Print " 
Copy--Sector Mode Disk Data 
($MASDF for Disk Management eae 
or Diskette Copy 4 | iskette Data 
or $MATDS Management 

Tape Data 

eee a 6 Management 


7 Close 


$05390255-1 


Chart 8.16.10 Library File-to-Print Copy—Sector Mode Control Flow 
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File-to-Library Copy—Sector Mode 5 —_siIf input file is from diskette, read the member from 


the file to the buffer. 
The file-to-library copy—sector mode routine copies 


specified members from a disk, diskette, or tape file to 6 If input file is from disk, read the member from the 
a library. It can only be used for files created by the file to the buffer. 

FROMLIBR procedure command. File-to-library copy is 

evoked by the TOLIBR procedure command via library 7 If input file is from tape, read the member from the 
maintenance mainline. file to the buffer. 

The following file-to-library copy—sector mode 8 Write the buffer to the library. 


processes are shown in Chart 8.16.11: 


9 Close the library. 
1 Find the specified library. 


10 Update the directory. 
2 Open the input file. 


11 Write the updated LCS to disk. 
3 Read the library control sector (LCS). 


12 Resolve disk address changes. 
4 Open the library. 


13 Close the input file and return to mainline. 
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Chart 8.16.11 File-to-Library Copy—Sector Mode Control Flow 
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Reader-to-Library Copy 
The reader-to-library copy routine copies records from 
the SYSIN device to the specified library. This routine is 


evoked via library maintenance mainline. 


The following reader-to-library copy processes are 
shown in Chart 8.16.12: 


1 Read the library control sector (LCS). 
2 Validate library member name. 

3 Open the library. 

4 Protect library member being created. 
5 Get a record from SYSIN. 

6 Put the record into the library. 


7 ~~ When end of file is reached, close the library and 
return to mainline. 


8 If no records were put in the library, do not place 
the member in the library; issue a halt message and 
return to mainline. 


Library Maintenance 
Utility Mainline 
(Chart 8.16.0) 
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Chart 8.16.12 Reader-to-Library Copy Control Flow 


2-310 
This document contains restricted materials of IBM. LY21-0590-4 
©Copyright IBM Corp. 1983, 1984, 1985, 1986 


Library Reallocate 


The library reallocate routine reallocates a specified 
library to allow members located in an extent to be 
placed in the library. The user can specify new library 
and directory sizes for the library to be reallocated, even 
if an extent does not exist. The library reallocate routine 
is evoked by the ALOCLIBR procedure command via 
library maintenance mainline. 


The following reader to library copy processes are 
shown in Chart 8.16.13: 


1 Resource enqueue the library. 
2 Read the library control sector (LCS). 


3 Allocate disk space to move the library. 


Library Maintenance 
Utility Mainline 


(Chart 8.16.0) 


Allocate 


Library 
Reallocate 
(SMARAL) 


Disk VTOC 
Access 


11 10 Deallocate 


Chart 8.16.13 Library Reallocate Control Flow 
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Copy the directory, the members and, if it exists, 
the file extent to the allocated disk space. 


Update the LCS. 
Fill any unused directory sectors with hex FF. 


Update the directory for any members moved from 
the file extent. 


Update the library format 1 and the extent format 1 
and write them back to the VTOC. 


Zero the old library and its extent. 
Deallocate the old library and its extent. 


Return to mainline. 


Control Storage 


Disk 1OS 
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Library Member Change 


The library member change routine can be used to 
change a library member's name, subtype, and/or 


6 If subtype and/or reference number change only, 
return to mainline. 


7 For rename only, check for member protection. 


reference number. The library member change routine is 


evoked by the CHNGEMEM procedure. 


The following member change processes are shown in 
Chart 8.16.14: 


1 Enqueue the library as a resource. 
2 Read the library control sector (LCS). 
3. If necessary, compact the directory. 


4 If name change requested, scan the directory for 
name match. 


5 lf subtype and/or reference number change only, 
find member to be changed and insert subtype 
and/or reference number in directory entry. 


Library 
Maintenance 

Utility Mainline 
(Chart 8.16.0) 


Library 
Member 
Change 


Library 
Compactor 
(SMACMP) 


(SMACHG) 


Directory 


Insert 
(SMAILD) 


Chart 8.16.14 Library Member Change Control Flow 
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8 If rename only, check for valid new name and scan 
for duplicate. 


9 Check for protection of members with new name. 


10 For rename only, mark old member directory entry 
as deleted. 


11 For rename only, insert new directory entry. 


12 For rename only, write LCS. 


13 Return to mainline. 


Control Storage 


2,4,8,10,12 


Librarian Find 


Member Protect 


7,9 
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MESSAGE BUILD UTILITY ($MGBLD) 


The message build utility creates message load 
members in a library. The load member contains 
formatted message text records that are retrieved by 
SSP message retrieve (FMGRET), via user-specified 
message identification codes (MIC). The message build 
utility is called by the CREATE procedure or by 
user-supplied OCL and utility control statements. 


The following message build utility processes are shown 
in Chart 8.17: 


1 Determine functions requested, then route, if 
necessary, for the following: 


e Process utility control information: 


Check syntax. 

Save REPLACE and SSP parameters in 
library control block (LCB). If REPLACE not 
specified, ensure duplicate name does not 
exist. 

lf user library specified, find library. 

Find and get source member. 


e Process source member control and source 
statements: 


Save member name in LCB. 

Allocate and open work file. 

Read message text statements and build 
messsage records in format required by 
#MGRET. 

Write records from |/O buffer to work file 
when buffer is full. 


e Create message member in library: 


Set up work file for sector input to disk. 
Fill |/O buffer with sectors from work file. 
Write |/O buffer to disk. 


« Terminate. 


2 Read and syntax check utility control statements. 
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Find specified library members for validity checking 
and get operations. 


Issue required messages. 


Find specified libraries for validity checking and 
member-get operations. 


Get source member. 
Allocate work file on disk. 
Open work file. 


Terminate message build utility. 
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Chart 8.17 Message Build Utility Control Flow 
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STOP BSC MONITOR UTILITY ($MMSP) 

The stop BSC monitor utility stops the automatic 
monitoring function of one of possibly four BSC 
multipoint lines. The stop BSC monitor utility is evoked 


by the STOPM system procedure or equivalent OCL. 


The following stop BSC monitor utility processes are 
shown in Chart 8.18: 


1 Do the following: 
e Route for syntax checking. 
¢ Determine line number. 
¢ Issue disable IOB to stop line monitoring. 
2 Syntax check utility control statements. 
3 Stop line monitoring. 
4 Issue any required messages. 


5 Terminate this job step. 


Initiator 


Control Storage 


Syntax Checker 


Stop BSC 


Monitor Utility 
($MMSP) : SYSLOG 


Termination 


: 


$0590260-0 
Chart 8.18 Stop BSC Monitor Utility Control Flow 
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START BSC MONITOR UTILITY ($MMST) 

The start BSC monitor utility starts the automatic 
monitoring function of one of possibly four BSC 
multipoint lines. The start BSC monitor utility is invoked 


by the STARTM system procedure or equivalent OCL. 


The following start BSC monitor utility processes are 
shown in Chart 8.19: 


1 Do the following: 
e Route for syntax checking. 
e Determine line number. 
« Determine code type (EBCDIC or ASCII). 
e Determine station specified. 
e Enable the line. 
e Issue an IOB to start line monitoring. 
2 Syntax check utility control statements. 
3 Perform line monitoring. 
4  \ssue any required messages. 


5 Terminate this job step. 


Initiator 


Syntax Checker Control Storage 


Start BSC 


Monitor Utility 
($MMST) 4 SYSLOG 


Termination 


: 
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Chart 8.19 Start BSC Monitor Utility Control Flow 
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DISK REORGANIZATION UTILITY ($PACK/$FREE) 


The disk reorganization utility reorganizes disk files so 
that free space on the disk is accumulated as specified 
by the user. The user calls the disk reorganization utility 
with the COMPRESS procedure command or with 
equivalent OCL and utility control statements; IPL file 
rebuild can also call disk reorganization via the transfer 
SVC instruction. 


The following disk reorganization utility processes are 
shown in Chart 8.20: 
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Initialize the utility with either $PACK (for 
System/32 compatibility) or with SFREE, noting 
whether the utility was called by user or by IPL file 
rebuild. 


If called by user for $FREE, read and syntax check 
the utility control statements. 


Issue any required messages. 


Create a table in TWS for each format-1 entry found 
on the system. 


If called by IPL file rebuild, update the format 5s to 
reflect the locations and quantity of free space. 


If FREEHIGH is specified (or implied by DISK-A1, 
DISK-ALL, or COMPRESS specified), accumulate 
free space at the high end of one or both disk 
drives. 


10 


11 


12 


14 


15 


16 


17 


If FREELOW is specified (or implied by DISK-A2), 
accumulate free space at the low end of one or 
both disk drives. 


If DISK-ALL is specified (or implied by COMPRESS 
statement default) accumulate free space at the low 
end of disk A2. 


Save COMPRESS request specifications in VTOC; 
need to restart and read format-1 entries to build 
the table. 


Read for format-1 entries of files to be moved and, 
after moving the file (to fill a gap on disk) update the 
format 1 and its table entry. 


Issue any required messages. 


Update the where-to-go tables of any 
IBM-supplied modules in moved user libraries. 


Update the spool file, job queue, message file, and 
security system files on any error exits. 


Issue any required messages. 

Update the format 5s to reflect the locations and 
quantities of free space, after the free space has 
been accumulated. 


Write the updated format 5s to disk. 


Update the PPSA addresses of any active 
procedures moved. 


If called from IPL file rebuild, return there; 
otherwise, transfer to termination exit to end the job 
step. 
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Chart 8.20 Disk Reorganization Utility Control Flow 


Section 2: SSP System Utility Programs Function 8 | 2-319 
This document contains restricted materials of IBM. LY21-0590-4 


©Copyright IBM Corp. 1983, 1984, 1985, 1986 


DEFINE AUTOCALL PHONE LIST UTILITY ($PNLM) 
The define autocall phone list utility either creates a new 
autocall phone list load member or alters an existing 
phone list load member. The define autocall phone list 
utility is invoked by the DEFINEPN system procedure or 
equivalent OCL. 


The following define autocall phone list utility processes 
are shown in Chart 8.21: 


1 Do the following: 

« Route for syntax checking. 

¢ Determine member program(s) specified. 
2 Syntax check utility control statements. 


3. Issue read/write requests for phone list load 
members. 


4 Issue any required messages. 


5 Terminate this job step. 


Initiator 


Control Storage 


Syntax Checker 


Define Autocall 


Phone List Utility 
($PNLM) 4 SYSLOG 


Termination 


5 
5 | 


S0590264-0 


Chart 8.21 Define Autocall Phone List Utility Control Flow 
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POST UTILITY ($POST) 3 Perform special E-diskette-to-disk copy: 


The post utility can convert a disk file to a diskette basic 4 Find diskette file to be copied. 
exchange file, convert diskette basic exchange file to a 

disk file, or can add a diskette basic exchange file or 5 Allocate diskette COPYIN file and disk COPYO 
diskette special E file to an existing disk file. If the input file: open DTF for each. 

file is a disk file, it can be a consecutive, indexed, or 

direct file; if the output file is a new disk file, it can be 6 Read records from the diskette file. 
consecutive or indexed; if the output file is an existing 

disk file, it must be a consecutive file. The post utility is 7 Write records to the disk file. 
evoked by the POST procedure command or by 

equivalent OCL and utility control statements. 8 Close the COPYIN and COPYO files. 
The following post utility processes are shown in Chart 9 Terminate this job step. 

8.22: 


10 Issue any required messages. 
1. Read and syntax check utility control statements. 


11 Perform basic exchange disk to diskette copy. 
2 Get active format 1 for COPYIN file and determine 


operation to be performed. 12 Perform basic exchange diskette to disk copy. 


13 Perform basic exchange diskette to SYSLIST copy. 
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Chart 8.22 Post Utility Control Flow 
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SECURITY SUPPORT 


Security support consists mainly of the security utilities 
that are evoked by IBM-supplied procedures. Also 
included under this topic are the security support 
modules; they are evoked by a variety of functions and 
are included here only as a convenience to the reader. 


Security Utilities 


The security utilities provide for password, badge, 
communications, and resource security. They are called 
by the following commands and parameters, or by 
equivalent OCL and utility control statements: 


e SECDEF USERID evokes the user identification file 
definition utility (SPRUID). 


e SECEDIT USERID evokes the user profile edit utility 
(SPRUED). 


e SECSAVE USERID evokes the user identification file 
save utility (BPRUSV). 


e SECREST USERID evokes the user identification file 
restore utility (SPRURS). 


e SECLIST USERID evokes the user profile list utility 
(SPRLST). 


¢ PASSWORD CHANGE evokes the password change 
utility (SPRPWD). 


¢ SECDEF RESOURCE evokes the resource security 
file definition utility (GSRRESC). 


e SECEDIT RESOURCE evokes the resource security 
edit utility (SRREDT) for files, libraries, and groups. 


« SECSAVE RESOURCE evokes the resource security 
file save utility (SRRSAV). 


¢ SECREST RESOURCE evokes the resource security 
file restore utility (SRRSTR). 


¢« SECLIST RESOURCE evokes the resource security 
list utility (SRRLST) for files, libraries, and groups. 


¢ SECEDIT COMM evokes the location profile edit 
utility (SPRCED). 


¢ SECLIST COMM evokes the location profile list 
utility (SPRCLT). 
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e SECEDIT OFFICE evokes the resource security edit 
utility (SRRTED) for folders and folder members. 


e SECLIST OFFICE evokes the resource security list 
utility (SRRTLT) for folders. 


e SECCONV converts the System/34 password 
security file and/or the System/34 resource security 
file to System/36 security file(s) (SPRCVT). 

For restrictions on the use of these procedure 

commands, refer to the System/36 System Security 


Guide. 


The following security utilities overview processes are 
shown in Chart 8.23.1.0: 


1 Process SECDEF USERID procedure command. 

2 Process SECEDIT USERID procedure command. 

3 Process SECSAVE USERID procedure command. 

4 Process SECREST USERID procedure command. 

5 Process SECLIST USERID procedure command. 

6 Process PASSWORD CHANGE procedure command. 
7 Process SECDEF RESOURCE procedure command. 
8 Process SECEDIT RESOURCE procedure command. 
9 Process SECSAVE RESOURCE procedure command. 
10 Process SECREST RESOURCE procedure command. 
11 Process SECLIST RESOURCE procedure command. 
12 Process SECEDIT COMM procedure command. 

13 Process SECLIST COMM procedure command. 

14 Process SECEDIT OFFICE procedure command. 

15 Process SECLIST OFFICE procedure command. 


16 Process SECCONV procedure command. 
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All disk accesses to the user identification file and the 
resource security file are processed by user identification 
file data management (@PRUDM) and resource security 
file data management (@RRDMT), respectively. These 
modules are loaded into the caller's address space and 
are branched to, like subroutines. The modules use 
control storage ASGN to obtain an area of SQS to 
contain the disk |OB and control storage disk |OS for 
scanning, reading, or writing the file data. 
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(Chart 8.23.1.1) 
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(Chart 8.23.1.2) 
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(Chart 8.23.1.3) 
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(Chart 8.23.1.5) 
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Chart 8.23.1.0 Security Utilities Overview Control Flow 
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Security User Identification File Definition Utility 3. Allocate the user identification file. 


The security user identification file definition utility 4 Read or write information from disk. 

creates and deletes the user identification file, activates 

and deactivates password security, activates and 5 Read or write to display station. 

deactivates badge security, and activates and deactivates 

password date checking. 6  Get/put, scramble/unscramble, user identification 
file records. 

The following security user identification file definition 

utility processes are shown in Chart 8.23.1.1: 7 Release the utility interlock so another security utility 
can run. 


1 Read and syntax check utility control statements. 


8 Issue any required messages. 
2 Get the utility interlock to ensure another security 


utility is not running. 9 Terminate this job step. 


(Chart 8.23.1.0) 
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Chart 8.23.1.1 Security User Identification File Utility Control Flow 
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Security User Profile Edit Utility 
The security user profile edit utility updates, adds, 
deletes, and locates user profiles in the user 


identification file. 


The following security user profile edit utility processes 
are shown in Chart 8.23.1.2: 


1 Get the utility interlock to ensure another security 
utility is not running. 


2 Open the display file at the display station. 
3 Build the termination exit block (TEB) in the TB. 


4 Read or write to display station. 


5  Get/put, scramble/unscramble, user identification 
file records. 
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10 


11 


12 


Special allocate the user identification file for an 
extend. 


Assign extend parameter list. 
Extend resource security file. 
Issue any required messages. 


lf abnormal termination occurs while TEB is active, 
perform cleanup function. 


Deactivate TEB in TB so termination will not take 
error exit. 


Release the utility interlock so another security 
utility can run. 


Terminate this job step. 
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(Chart 8.23.1.0) 
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Chart 8.23.1.2 Security User Profile Edit Utility Control Flow 
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User Identification File Save Utility 


The user identification file save utility saves the user 
identification file on disk, diskette, or tape. 


The following user identification file save utility 
processes are shown in Chart 8.23.1.3: 


1 Get the utility interlock to ensure another security 
utility is not running. 


2 Read from, or write to, disk, diskette, or tape. 


3 Allocate the job file (FSECCOPY) to receive the copy 
of the user identification file. 


4 Get/put, scramble/unscramble, user identification 
file records. 


5 Release the utility interlock so another security utility 
can execute. 


6 Terminate this job step. 


(Chart 8.23.1.0) 
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Chart 8.23.1.3 User Identification File Save Utility Control Flow 
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User Identification File Restore Utility 


The user identification file restore utility restores the 
user identification file on disk from a disk, diskette, or 
tape file created by SECSAVE. 


The following user identification file restore utility 
processes are shown in Chart 8.23.1.4: 


1 Read and syntax check the utility control 
statements. 


2 Get the utility interlock to ensure another security 
utility is not running. 


3 Activate the termination exit block (TEB) in the TB. 


4 Read from, or write to, disk, diskette, or tape. 


5 Allocate the new user identification file. 
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12 


13 


Allocate the previously created job file (ZSECREST). 


Get/put, scramble/unscramble, user identification 
file records. 


Issue any required informational message(s). 
Issue any required message(s). 
Delete the user identification file. 


Deactivate TEB in TB so termination will not take 
error exit. 


Release the utility interlock so another security utility 
can execute. 


Terminate this job step. 
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(Chart 8.23.1.0) 
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Security User Profile List Utility 

The security user profile list utility lists user profiles from 
the user identification file to either the system printer or 
to the display station. The output is sorted alphabetically 
within the security class or alphabetically by USERID. 


The following security user profile list utility processes 
are shown in Chart 8.23.1.5: 


1 Read and syntax check the utility control 
statements. 


2 Get the utility interlock to ensure another security 
utility is not running. 


3 Allocate and open the disk work file. 
4 Activate the termination exit block (TEB) in the TB. 


5 Retrieve and unscramble user profiles in the user 
identification file. 


6 Put records to the disk work file. 


7 Read configuration sector for security; zero disk 
work file on error. 
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13 


14 


15 


16 


Get heading lines. 

Get time and date for headings. 
Get records from disk. 

List user identification file records. 


Deactivate TEB in TB so termination will not take 
error exit. 


Release the utility interlock so another security 
utility can execute. 


Issue any required messages. 
lf error occurs while TEB active, process error. 


Terminate this job step. 
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Password Change Utility 5 Get/put, scramble/unscramble, the user profile of 


the user requesting to change his or her password. 
The password change utility allows a user to change his 


or her password. The user password is in the user 6 Issue any required messages. 
profile of the user identification file. 
7 ‘If abnormal termination occurs while TEB is active, 
The following password change utility processes are perform cleanup function. 
shown in Chart 8.23.1.6: 
8 Deactivate TEB in TB So termination will not take 
1 Get the utility interlock to make sure another error exit. 
security utility is not running. 
9 Release the utility interlock so another security 
2 Open the display file at the display station. utility can run. 


3 Build the termination exit block (TEB) in the TB. 10 Terminate this job step. 


4 Read and write to display station. 


Control Storage 


Special Allocate 


Open 
EI 


Work Station 
Data Management 
Security Data Ee 


Management 
(@PRUDM) 


Password 
Change 
Utility 


6 SYSLOG 
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Resource Security File Definition Utility 


The resource security file definition utility creates and 
deletes the resource security file and activates and 
deactivates resource security. 


The following resource security file definition utility 
processes are shown in Chart 8.23.1.7: 


1 Read and syntax check utility control statements. 

2 Get the utility interlock to ensure another security 
utility is not running. 

3 Allocate the new resource security file or allocate 
the old resource security file so it can be deleted. 

4 Open the file. 

5 Read from, or write to, disk. 

6 Read or write to display station. 

7  Get/put, scramble/unscramble, resource security 
file records. 

8 Delete the resource security file from the VTOC. 

9 Release the utility interlock so another security utility 
can execute. 

10 Issue any required messages. 

11 Terminate this job step. 
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Resource Security File Edit Utility 10 Read/write security configuration sector. 


The resource security file edit utility updates, adds, 11 Issue any required messages. 
deletes, and finds resource security file information on 
files, libraries, and groups. 12 If abnormal termination occurs while TEB is active, 


perform cleanup. 
In addition to being called from the security menu, the 


resource security file edit utility can also be called by 13 Deactivate TEB in TB so termination will not take 
privileged programs such as PS/36 to prompt the user error exit. 


for file or library security. 


14 Release the utility interlock so another security utility 
The following resource security file edit utility processes can run. 


are shown in Chart 8.23.1.8: 


15 If $RREDT has been called by another program, 
1 Get the utility interlock to ensure another security exit. 


utility is not running. 


16 Terminate this job step. 
2 Activate the termination exit block (TEB) in the TB 


so controlled cancel can be done even if the job is 
canceled. 
3 Open the display format. 


4 Read or write to display station. 


5  Get/put, scramble/unscramble, resource security 
file records. 


6 Read/write VTOC, marking files and libraries as 
secure or unsecure. 


7 Special allocate the resource security file for an 
extend. 


8 Assign extend parameter list. 


9 Extend resource security file. 
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Resource Security File Save Utility 3. Allocate the job file (#SECCOPY) where the copy of 


the resource security file is saved. 
The resource security file save utility saves the resource 


security file on disk, diskette, or tape. 4 Get/put, scramble/unscramble, resource security 


file records. 
The following user identification file save utility 


processes are shown in Chart 8.23.1.9: 5 Release the utility interlock so another security utility 


can execute. 
1 Get the utility interlock to ensure another security 


utility is not running. 6 Issue any required messages. 


2 Read from, or write to, disk, diskette, or tape. 7 Terminate this job step. 
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Resource Security File Restore Utility 


The resource security file restore utility restores, as the 
current resource security file, a saved copy on disk, 
diskette, or tape. 


The following user identification file restore utility 
processes are shown in Chart 8.23.1.10: 
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Read and syntax check the utility control 
statements. 


Get the utility interlock to ensure another security 
utility is not running. 


Activate the termination exit block (TEB) in the TB. 


Allocate the new resource security file. 


Allocate the previously created job file (ZSECREST). 


Read from or write to disk, diskette, or tape. 


Get/put, scramble/unscramble, resource security 
file records. 


10 


11 


12 


13 


14 


15 


16 


17 


Delete the old resource security file. 
Get the VTOC format-1 interlock. 


Search the VTOC for each file record in the 
resource security file. 


Release the disk interlock. 


Release the utility interlock so another security utility 
can execute. 


Issue any required informational messages to the 
system console. 


Issue any required messages. 


If abnormal termination occurs while TEB is active, 
perform cleanup. 


Deactivate TEB in TB so termination will not take 
error exit. 


Terminate this job step. 
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Resource Security File List Utility 9 Close the disk work file. 


The resource security file list utility lists resource 10 Sort the work file alphabetically within security 
security file information on files, libraries, and groups to class. 

the SYSLIST device. The output is sorted according to 

user specifications contained in the utility control 11 Allocate the work file for output. 

statements. 


12 Get heading lines. 
The following resource security file list utility processes 


are shown in Chart 8.23.1.11: 13 Get time and date for headings. 
1 Read and syntax check the utility control 14 Get records from disk. 
statements. 


15 List file, library, and group security information. 
2 Get the utility interlock to ensure another security 


utility is not running. 16 Deactivate TEB in TB so termination will not take 


error exit. 
3 Allocate and open the disk work file. 


17 Release the utility interlock so another security utility 


4 Activate the termination exit block (TEB) in the TB. can run. 
5 Retrieve file records and user records. 18 Issue any required messages. 
6 Search the VTOC for each file record in the 19 \f error occurs while TEB active, process error. 


resource security file. 


20 Terminate this job step. 
7 Put records to the disk work file. 


8 Read configuration sector for security; zero disk 
work file on error. 
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Security Location Profile Edit Utility 


The security location profile edit utility updates, adds, 
deletes, and finds location profiles in the user 
identification file. 


The following security location profile edit utility 
processes are shown in Chart 8.23.1.12: 


1 


Get the utility interlock to ensure another security 
utility is not running. 


2 Open the display file at the display station. 

3 Build the termination exit block (TEB) in the TB. 

4 Read or write to display station. 

5  Get/put, scramble/unscramble, location profiles. 

6 Special allocate the user identification file for an 
extend. 

7 Assign extend parameter list. 

8 Extend resource security file. 

9 Get time/date stamp information. 

10 Issue any required messages. 

11 If abnormal termination occurs while TEB is active, 
perform cleanup function. 

12 Deactivate TEB in TB so termination will not take 
error exit. 

13 Release the utility interlock so another security 
utility can run. 

14 Terminate this job step. 
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Security Location Profile List Utility 12 Get records from disk. 


The security location profile list utility lists location 13 List location profiles. 

profiles from the user identification file to either the 

system printer or to the display station. The output is 14 Deactivate TEB in TB so termination will not take 
sorted alphabetically by location name. error exit. 

The following security location profile list utility 15 Release the utility interlock so another security utility 
processes are shown in Chart 8.23.1.13: can run. 

1 Get the utility interlock to ensure another security 16 Issue any required messages. 


utility is not running. 


17 If error occurs while TEB active, process error. 
2 Allocate and open the disk work file. 


18 Terminate this job step. 
3 Activate the termination exit block (TEB) in the TB. 


4 Retrieve and unscramble location profiles in the user 
identification file. 


5 Put records to the disk work file. 


6 Read configuration sector for security; zero disk 
work file on error. 


7 Close the disk work file. 

8 Sort the work file alphabetically by location name. 
9 Allocate the work file for output. 

10 Get heading lines. 


11 Get time and date for headings. 
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Resource Security File Edit Utility for Folders and Folder 
Members 


The resource security file edit utility for folders and 
folder members updates, adds, deletes, and locates 
security information on folders and folder members. 


In addition to being called from the security menu, the 
resource security file edit utility for folders and folder 
members is also called by the OFFICE/36 program 
products. 


The following resource security file edit utility processes 
are shown in Chart 8.23.1.14: 


1 Get the utility interlock to ensure another security 
utility is not running. 


2 Activate the termination exit block (TEB) in the TB 
so controlled cancel can be done even if the job is 


canceled. 
3 Get heading lines. 
4 Open the display format. 


5 Special allocate the work files. 
Open the work files. 


7  Get/put, scramble/unscramble, security information 
for folders and folder members. 


8  Get/put entries from/to the work file. 
9 Read or write to display station. 


10 If called by one of the text processing utilities, map 
to caller's TMIO parameter list. 
11 Open/close folders and folder members and 


get/put DDA (data descriptor area). 
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12 


13 


14 


15 


16 


17 


18 


19 


20 


21 


Mark VTOC entries for folders secured or 
unsecured, as required. 


Issue any required messages. 
Special allocate the resource security for an extend. 
Assign extend parameter list. 
Extend resource security file. 


Read/write security configuration sector; zero disk 
work files. 


If abnormal termination occurs while TEB is active, 
perform cleanup. 


Deactivate TEB in TB so termination will not take 
error exit. 


Release the utility interlock so another security utility 
can run. 


Terminate this job step. 
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Resource Security File List Utility for Authorization Lists 12 Get time and date for headings. 
and Folders 


13 Get records from disk. 
The resource security file list utility for authorization lists 


authorization lists and folders to the SYSLIST device. 


15 Deactivate TEB in TB so termination will not take 
The following resource security file list utility for folders error exit. 


processes are shown in Chart 8.23.1.15: 


16 Release the utility interlock so another security utility 
1 Read and syntax check the utility control can run. 


statements. 


17 \ssue any required messages. 
2 Get the utility interlock to ensure another security 


utility is not running. 18 If error occurs while TEB is active, process error. 


3 Allocate and open the disk work file. 19 Terminate this job step. 
4 Activate the termination exit block (TEB) in the TB. 


5 Retrieve authorization lists and folders security 
information from the user identification file. 


6 Search the VTOC for each folder record in the 
resource security file. 


7 Put records in the disk work file. 


8 Read configuration sector for security; zero out disk 
work file on error. 


9 Close the disk work file. 
10 Allocate the work file for output. 


11 Get heading lines. 
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Security File Conversion Utility 5 Open the converted user identification file, put 
scrambled records, and close the file. 

The security file conversion utility converts either or both 

of the System/34 password security file and resource 6 Open the converted resource security file, put 

security file to the System/36 user identification file and scrambled records, and close the file. 

resource security file. 


7 Write the index sector for the converted user ID file 


The following security file conversion utility processes and converted resource security file. 


are shown in Chart 8.23.1.16: 


8 Close the diskette file. 
1 Read and syntax check the utility control 


statements. 9 If error, delete the converted security file(s). 
2 Allocate and open the System/34 security diskette 10 Issue any required messages. 
file. 


11 Terminate this job step. 
3 Allocate the security files on disk. 


4 Read in a diskette buffer. 


(Chart 8.23.1.0) 
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Chart 8.23.1.16 Security File Conversion Utility Control Flow 
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Security Support Modules 2 Write resource security configuration sector 


information. 
The security support modules perform various security 


services for other SSP functions. They are not evoked 3 Search VTOC for secured files. 
as utilities and are included under this topic for reader 


convenience only. 4 Search resource security file for secured files. 


5 Write password security configuration sector 


Security IPL Modules information. 
The following security IPL processes are shown in Chart 6 ‘Find user identification file. 
8.23.2.1: 


7 ‘Issue any required messages. 
1 Do the following, routing control where necessary: 


8 Determine if user is authorized to reload a secured 
e Check resource security status. system and close the file. 


« Set up resource security information in SCA. 9 Scan user identification file for user profile. 


e In work area, record any errors detected. 
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Change User Security Profile 


Change user security profile alters the user default 
menu, default library, and/or the beginning help menu 
fields in the user’s profile. It is evoked by command 
processor help, when the user presses command key 23 
or 24. 


The following change user security profile processes are 
shown in Chart 8.23.2.2: 


1 Get security files interlock to ensure no other 
security module shares access to the file. 


2 Read/write/scan user identification file records. 


3 Release security files interlock. 


Control Storage 


Help Command Keys 


Change User =| («| pe------------ | 
Security Profile | 
WPRCG) |  £<@)| presse see =- 
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Chart 8.23.2.2 Change User Security Profile Control Flow 
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Password Sign-On 


If password security is active, password sign-on 
determines if the user is authorized to sign on the 
system. Whether security is active or not, the sign-on 
transient passes the user profile back to the caller at 
sign-on time. 


The following password sign-on processes are shown in 
Chart 8.23.2.3: 


1 Get security files interlock to ensure no other 
security module shares access to the file. 


2 Read/write/scan user identification file records. 


3 Release security files interlock. 


Control Storage 
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Security Bind Processor 
The security bind processor is called to verify the remote 
location's password when the APPC subsystem starts a 


session (if password security is active). 


The following security bind processor processes are 
shown in Chart 8.23.2.4: 


1 Get the user ID file interlock to ensure no other 
security programs can write or move the file. 


2  Read/scan the user ID file for the appropriate 
location profile. 


3 Encrypt the random seed using the location 
password as a key. 


4  \ssue any required information messages to the 
system console and log them to the history file. 


5 Release the user ID file interlock. 


APPC Subsystem 


Control Storage 


Security 
Bind 
Processor 
(#PRBND) 


Initiator Command 
Interface 
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Chart 8.23.2.4 Security Bind Processor Control Flow 
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Resource Security Check One 5 Get the history file message. 


Resource security check one verifies that the user is 6 Put message to history file. 
authorized to use a file, library, or folder. It is called 

when a user attempts to allocate a file or folder, or to 7 Release security files interlock. 
find a library. 


8 Issue any required messages. 
The following resource security check one processes are 


shown in Chart 8.23.2.5: 9 Terminate this job step. 


1 Get resource security file interlock to ensure no 
other security program moves the file. 


2 Map to requester’s DTF. 
3 Free main storage security element. 


4  Read/scan resource security file records. 


Special Allocate / 
Allocate / Deallocate 


Control Storage 


1 
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Chart 8.23.2.5 Resource Security Check One Control Flow 
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Resource Security Check Two 3 Get the history file message. 


Resource security check two verifies that the user is 4 Put message to history file. 
authorized to attach a task that may have secured 

resources allocated. 5 Release security files interlock. 
The following resource security check two processes are 6 Issue any required messages. 


shown in Chart 8.23.2.6: 


7 Terminate this job step. 


1 Get resource security file interlock to ensure no 
other security program moves the file. 


2  Read/scan user resource security file records. 
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Chart 8.23.2.6 Resource Security Check Two Control Flow 
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Resource Security Check Three 


3 Read or scan resource security file records. 


Resource security check three verifies that the user is 4 Read security information for the file, library, or 
authorized to rename a secured file, library, or folder. folder. 
The following resource security check three processes 5 Release security file interlock. 


are shown in Chart 8.23.2.7: 


6 Issue any required messages and log messages to 


1 Get security file interlock to ensure no other security the history file. 


module moves the file. 


7 Terminate this job step. 


2 Get assign/free area for IOB. 


File Rename 
Utility 


(Chart 8.16) 


Control Storage 


VTOC 
Read/Write 


Resource Security 
Check Three 
(#RRAS3) 


SYSLOG 


7 Termination 


$0590285-0 


Chart 8.23.2.7 Resource Security Check Three Control Flow 
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Resource Security Check Four 


Resource security check four verifies that the user is 
authorized to access a folder member. It also returns 
the user’s access level to a file, library, or folder. 


The following resource security check four processes are 
shown in Chart 8.23.2.8: 


1 Get resource security file interlock to ensure no 
other security module moves the file. 
2  Read/scan resource security file records. 


File Rename 
Utility 


(Chart 8.16) 


Resource Security 
Check Four 
(HRRA4) 


Chart 8.23.2.8 Resource Security Check Four Control Flow 
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3 Free the main storage security element. 

4 Read security information for the file, library, or 
folder. 

5 Release security file interlock. 

6 Issue any required messages and log messages to 
the history file. 

7 Terminate this job step. 


Control Storage 
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FILE/LIBRARY/FOLDER RENAME UTILITY 
(SRENAM) 


The file/library/folder rename utility changes disk file, 
user library, or folder names. The file, library, or folder 
name to be changed is specified by file/library/folder 
label. A file to be changed can also be specified by date; 
if no date is specified, the most recent file of the 
specified name is renamed. If the old file name is 
defined in the network resource directory (NRD), it is 
renamed on the remote system. The rename utility is 
invoked by the RENAME procedure or by user-supplied 
OCL and utility control statements. 


The following file/library/folder rename utility processes 
are shown in Chart 8.24: 


1 Check syntax of utility control information. 
2 Lock disk format 1's. 


3 Ensure that old file/library/folder exists and that 
new file/library/folder does not exist. 


4 \fthe old file exists in the NRD, call DDM source 
rename file function. 


5 Special allocate the file/library/folder. 


6 If resource security is active, check user 
authorization to file/library/folder. 


7 Write new file/library/folder name (with latest data 
indicator) to disk VTOC. 


8 If old file was the latest file with multiple files of the 
same label, write the latest date indicator to disk 
VTOC. 

9 Unlock disk format 1's. 


10 Deallocate the file/library/folder. 


11 Issue error messages if necessary. 


2-366 


This document contains restricted materials of IBM. LY21-O590-4 
©Copyright IBM Corp. 1983, 1984, 1985, 1986 


initiator 


File Rename Syntax Checker 
Initialization 


($RENAM) 6 


Control Storage 


DDM Source 
Rename File 
(ARDSR) 


Disk 
VTOC 
Access 


Special Allocate 


File Rename 
VTOC Update 
(SRENF1) 


Resource Security 
(Chart 8.23) 


10 Deallocate 


SYSLOG 


$0590286-2 


Chart 8.24 File/Library Rename Utility Control Flow 
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WORK STATION CONFIGURATION ($SETCF) The $SETCF utility modifies only the configuration 
records associated with a work station. It can be 


The work station configuration utility changes items in a evoked by the SET, PRINTKEY, and ALTERCOM 

display station's configuration record or in its procedure commands or by equivalent OCL and utility 

communications configuration record. Each display control statements. 

station that is defined as a command display station 

during system configuration has an associated display The following $SETCE utility processes are shown in 

station configuration record and communications Chart 8.25: 

configuration record. The communications and work 

station configuration records were originally built from 1 Modify values in the associated terminal's work 

the UDT and system configuration record. The station configuration record or communications 

environment items that can be changed by the work configuration record, routing control where 

station configuration utility include: necessary. 

e Display station 2 Read and syntax check utility control statements. 

e BSC 3 Issue any required messages. 

e Local area network (LAN) 4 When END statement is read, terminate this job 
step. 

e SDLC 


e Asynchronous 


e User program BSC specifications 


Initiator 


Syntax Checker 


SYSLOG 


Work Station 6 | 
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Chart 8.25 Work Station Configuration Utility Control Flow 
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COMMUNICATIONS CONFIGURATION UTILITY 
($SETCP) 


The communications configuration utility allows the user 
to alter certain communications configuration bits in the 
system configuration record on disk, after the system 
has been preset by IBM manufacturing or the customer 
engineer/customer service representative. The utility is 
evoked by the SETCOMM system procedure or 
equivalent OCL, and executes as a MRT program that 
can be executed only in a dedicated environment. The 
system IPL must be performed before the changes are 
effective. 


The following communications configuration utility 
processes are shown in Chart 8.26: 


1 Alter system communications configuration record 
according to user requests, routing control where 
necessary. 

2 Syntax check utility control statements. 


3  Read/write configuration record to disk. 


4  \ssue any required messages, including message 
stating that system IPL must be performed. 


5 Terminate this job step. 
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Chart 8.26 Communications Configuration Utility Control Flow 
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SCREEN FORMAT GENERATOR UTILITY ($SFGR) 


The screen format generator utility processes 
user-generated or compiler-generated display format 
specifications and produces a display format(s) in a 
specified load member. It is evoked by the FORMAT 


procedure command, by program product procedures, or 


by equivalent OCL and utility control statements. 


The following screen format generator utility processes 
are shown in Chart 8.27: 


1 Read and syntax check utility control statements. 
2 Process required messages to the operator. 

3 Prepare work file to read source records. 

4 Build data stream for formats processed. 

5 If required, resequence out-of-order fields. 


6 Perform load member maintenance: 


« Calculate size of new or replaced load member. 


e Write the format to the library format load 
member. 


e Delete formats as required in this copy process. 
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Chart 8.27 Screen Format Generator Utility Control Flow 
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DISPLAY SPOOL FILE ENTRIES UTILITY ($UASC) 
The display spool file entries utility allows the user to 
inspect the spool file entries placed in a user file by the 
spool file utility (GUASF). In addition to viewing the 
Output, the user can print a copy of the spool file 
information on the session printer. The user can view 
Output in four different modes: 

e Header mode 

e Paging mode 

e Record mode 


«  Full-line mode (132-character display only) 


The utility is called by the COPYPRT system procedure 
or by equivalent OCL and utility control statements. 


Initiator 


Format-1 Access 


Disk Data 
Management 
Display Spool 
File Entries 


Utility 
(SUASC) 


Termination 


Chart 8.28 Display Spool File Entries Utility Control Flow 


The following display spool file entries utility processes 
are shown in Chart 8.28: 


1 Read format 1. 


2 Allocate and open printer DTF and required files. If 
specified, allocate and open work station DTF. 


3 Get records from disk. 

4  |f specified, print records. 

5 If specified, display entries to display screen. 
6 Close files. 


7 Terminate this job step. 
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USER ACCESS TO SPOOL FILE UTILITY ($UASF) 


The user access to spool file utility copies entries from 
the spool file to a user disk file in expanded format. The 
user invokes the utility through the COPYPRT procedure 
or appropriate OCL and utility control statements to do 
one of the following: 


« Copy a single spool file entry 


« Copy all of a user’s entries with a specified forms 
number 


« Copy all of a user's entries 


¢ Copy the entire spool file (requester’s security level 
must be appropriate) 


The header and data records copied are 150 characters 
in length for 132-print-position printer; for print line 
lengths greater than 132 print positions, the data record 
length is 215 bytes. 


Note: The COPYPRT procedures also invokes the 
display spool file entries utility, SUASC (Chart 8.28). 
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Chart 8.29 User Access to Spool File Utility Control Flow 


The following user access to spool file utility processes 
are shown in Chart 8.29: 


1 Read and syntax check utility control statements. 
2 Allocate file (SUSAF calculates file size). 


3 Write records to disk (SUSAF expands from 
compressed format and removes SCS commands). 


4 Close file. 
5 Issue any required messages. 


6 Terminate. 


Syntax Checker 


User File Special 
Allocate and Open 


Close 


Termination 
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TAPE INITIALIZATION UTILITY ($TINIT) 

The tape initialization utility prepares magnetic tape for 
use. It is evoked via the TAPEINIT procedure or 
equivalent OCL and utility control statements. It 


performs the following functions: 


¢ Check the first file on tape to ensure that it has not 
expired before writing a new volume label. 


e Unconditionally initialize tape, ignoring file label and 
file expiration status. 


e Erase the tape by writing blanks on the tape after 
label processing (data security erase). 


The following tape initialization utility processes are 
shown in Chart 8.30: 


1 Read and syntax check utility control statements. 
2 Allocate tape drive. 

3 Perform requested function. 

4 Issue any required message. 


5 Terminate this job step. 
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Chart 8.30 Tape Initialization Utility Control Flow 
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TAPE COPY UTILITY ($TCOPY) 


The tape copy utility can be used to exchange data 
among tape, disk and the SYSLIST device. 


The following tape copy processes are shown in Chart 
8.31.0: 


1 Read and syntax check utility control statements. 
2 Process any required messages. 


3 Get disk and/or tape AFAs based on contents of 
COPYIN and COPYO file statements. 


4 I\f DISPLAY utility control statement, display tape 
file on SYSLIST device. 


5 If TRANSFER utility control statement specifies 
COPYIN disk file, transfer or add a disk file to a 
tape file. 


6 If TRANSFER utility control statement specifies 
COPYIN tape file, transfer or add a tape file to a 
disk file. 


Initiator 
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Gi SYSLOG Active Format-1 
2 oO Area Access 
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Tape 6 | 


Copy 

Utility | 

(STCOPY) Copy Tape File 
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Chart 8.31.0 Tape Copy Utility Overview Control Flow 
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Tape File to SYSLIST Copy 4 Read tape records. 


Tape file to SYSLIST copy displays or prints the 5 If record’s RRN is within limits, display or print 
contents of a tape file at the SYSLIST device. record. 
The following tape file to SYSLIST copy processes are 6 Close tape DTF. 


shown in Chart 8.31.1: 


7 \Issue any required messages. 
1 Allocate tape COPYIN file and SYSLIST device. 


8 Terminate this job step. 
2 Set up display or printer parameter list. 


3 Open tape COPYIN file. 
Tape Copy 


Utility 
(Chart 8.30.0) 
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Chart 8.31.1 Tape File to SYSLIST Copy Control Flow 
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Disk File to Tape File Copy 4 Read disk records. 


Disk file to tape file copy transfers data from a 5 Write records to tape. 
sequential or indexed disk file to a tape file or adds data 

from a sequential disk file to a tape file. 6 Close disk and tape DTFs. 
The following disk file to tape file copy processes are 7 Issue any required messages. 


shown in Chart 8.31.2: 


8 Terminate this job step. 
1 Allocate COPYIN file, COPYOUT file, and tape 
device. 


2 Diagnose request, set up required tape data 
management and tape buffers. 


3 Open disk and tape DTFs. 


Tape Copy 
Utility 
(Chart 8.30.0) 


1 Allocate 
OPEN 
3 . 
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Disk File to Tape Data 
Tape File Copy Management 
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Chart 8.31.2 Disk File to Tape File Copy Control Flow 
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Tape File to Disk File Copy 


Tape file to disk file copy transfers data from a tape file 
to a sequential or indexed disk file or adds data from a 
tape file to a sequential disk file. 


The following tape file to disk file copy processes are 
shown in Chart 8.31.3: 


1 Allocate COPYIN file, COPYOUT file, and tape 
device. 


2 Diagnose request, set up required tape data 
management and tape buffers. 


Tape Copy 
Utility 
(Chart 8.30.0) 


1 Allocate 


Disk File to 
Disk File Copy 
(STCTFD) 


Disk Data 


Management 


Termination 


Chart 8.31.3 Tape File to Disk File Copy Control Flow 


2-378 


3 Open disk and tape DTFs. 

4 Read tape records. 

5 Write records to disk. 

6 Close disk and tape DTFs. 

7 ‘Issue any required messages. 


8 Terminate this job step. 
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Tape Data 
Management 
Close 
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EXTENDED CHARACTER FILE RESTORE UTILITY 
($XREST) 


The extended character file restore utility allows the user 
to restore the extended character file from a diskette 
file. The user can selectively restore the IBM-supplied 
extended character file, user-defined characters, or a 
specified portion of the user-defined characters. The 
extended character file restore utility is evoked by the 
RESTEXTN system procedure or by equivalent 
user-supplied OCL and utility control statements. 


The following extended character file restore utility 
processes are shown in Chart 8.32: 


1 Find and check COPYIN and COPYO AFAs. 
2 If diskette magazine drive, find correct diskette. 


3 Allocate and open the diskette file to be restored to 
disk. 


4 Allocate, open, and process the header disk file 
named #HDR1818 or #HDR2424. 


5 Check syntax of utility control statements. 


6 Determine if a new extended character file must be 
allocated. 


7 Allocate the extended character disk file. 

8 Open the extended character disk file. 

9 Get records from diskette file. 
Note: Diskette data management module #DRDI is 
used when restoring a file saved on System/36 via 
$XSAVE or an I-format file from any other system. 
Diskette data management module #DRSM is used 


when restoring a file saved on System/34. 


10 Put records to the extended character file by relative 
record number. 


11 Create the valid code point table if needed. 
12 Update header disk file. 


13 Close extended character file, header disk file, and 
diskette file. 


14 Process any required messages. 


15 Terminate this job step. 
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EXTENDED CHARACTER FILE SAVE UTILITY 
($XSAVE) 


The extended character file save utility allows the user 
to save the extended character file in an |-format 
diskette file. The user can selectively save the 
IBM-supplied extended character file, user-defined 
characters, or a specified portion of the user-defined 
characters. The extended character file save utility is 
evoked by the SAVEEXTN system procedure or by 
equivalent user-supplied OCL and utility control 
statements. 


The following extended character file save utility 
processes are shown in Chart 8.33: 


1 Find and check COPYIN and COPYO AFAs. 
2 If diskette magazine drive, find correct diskette. 


3 Allocate the diskette file on which characters are to 
be saved. 


4 Allocate, open, read, and process header disk file 
#HDR1818 or #HDR2424. 


5 Close the header disk file. 

6 Check syntax of utility control information. 
7 Allocate the extended character disk file. 
8 Open the extended character disk file. 

9 Open the diskette file. 

10 Write header records to the diskette file. 


11 Get records, by relative record number, from the 
extended character file. 


12 Put records to diskette file. 
13 Close extended character disk file and diskette file. 
14 Process any required messages. 


15 Terminate this job step. 
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Chart 8.33 Extended Character File Save Control Flow 
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Network Resources Directory (NRD) Utilities 

The network resources directory (NRD) utilities allow the 
user to edit, Save, restore, or delete the NRD. The user 
invokes the NRD utilities via the appropriate procedures 
or equivalent OCL statements. 

EDITNAD Utility 

The EDITNRD utility allows the user to create the 
network resource directory (NRD) file and edit entries in 


the NRD file. 


The following EDITNRD utility processes are shown in 
Chart 8.34: 


1 Initialize for NRD utility and route control for 
requested function. 


2 Perform initialization for interactive environment. 
3 Determine if NRD file exists or not. 

4 Allocate a new NRD file if it does not exist. 

5 Perform requested edit functions on NRD file. 


6 Issue any required messages and log messages to 
the history file. . 


7 Terminate this job step. 
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Chart 8.34 EDITNRD Utility Control Flow 
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SAVENRD Utility 


The SAVENRD utility allows the user to save the 
network resource directory (NRD) file on diskette or tape. 


The following SAVENRD utility processes are shown in 
Chart 8.34.1: 


1 Copy NRD file to save medium. 


Initiator Diskette /Tape/Tape 
(SCOPY) 


Data Management 


S0590453-0 
Chart 8.34.1 SAVENRD Utility Control Flow 
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RESTNAD Utility 
The RESTNRD utility allows the user to restore a 
previously saved network resource directory (NRD) file 


to the system from diskette or tape. 


The following RESTNRD utility processes are shown in 
Chart 8.34.2: 


1 Copy NRD off save medium to temporary file. 
2 Allocate NRD file. 

3 Copy temporary file to NRD file. 

4 Issue any required messages. 


5 Terminate this job step. 


Initiator 1] Diskette/Tape/Tape 
(SCOPY) Data Management 
2 Allocate 
Disk Data 
Management 

NRD Fa | 
Conversion 
(SSINCT) 

4 SYSLOG 


Termination 


$0590454-0 
Chart 8.34.2 RESTNRD Utility Control Flow 
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DELNAD Utility 


The DELNRD utility allows the user to delete the network 
resource directory (NRD) file from the system. 


The following DELNRD utility processes are shown in 
Chart 8.34.3: 


1 Allocate file. 
2 Delete file. 
3 Issue any messages. 


4 Terminate this job step. 
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Chart 8.34.3 DELNRD Utility Control Flow 
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LISTNAD Utility 
The LISTNRD utility allows the user to list the entries in 
the network resource directory (NRD) on the SYSLIST 


device. 


The following LISTNRD utility processes are shown in 
Chart 8.34.4: 


1 Read and syntax check control statements. 


2 Allocate NRD file. 
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Chart 8.34.4 LISTNRD Utility Control Flow 
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Use disk IOS to read NRD entries. 
Display sorted and formatted entries. 
Deallocate NRD. 

Issue any required messages. 


Terminate this job step. 
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Folder Management Services (FMS) Utility 
(STMSERV) 


The folder management services (FMS) utility can be 
used to perform any of the following functions: 


e Save a single folder to a disk, diskette, or tape file. 


e Save all folders on the system to diskette or tape 
files. 


e Restore a saved folder from a disk, diskette, or tape 
file. 


e Reorganize a folder. 


e Save folder members to a disk, diskette, or tape 
file. 


e Restore saved folder members from a disk, 
diskette, or tape file. 


e List information about archived members from a 
diskette or tape file. 


« Move a folder from one location to another on a 
disk. 


The FMS utility is invoked by the following system 
procedures or equivalent utility control statements 
(UCLs): SAVEFLDR, RESTFLDR, ALOCFLDR, CONDENSE, 
ARCHIVE, RETRIEVE, LISTFILE, and MOVEFLDR. 
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The following FMS utility processes are shown in Chart 
8.35: 


1 Read and syntax check utility control statements. 
2 Issue any required messages. 


3 Process request to ARCHIVE folder member to disk, 
diskette, or tape file. 


4 Process request to RETRIEVE folder member from 
disk, diskette, or tape file. 


5 Process request to perform LISTFILE of archived 
folder member on a diskette or tape file. 


6 Process request to perform ALOCFLDR or 
CONDENSE folder. 


7 Process request to SAVEFLDR a folder to a diskette 
or tape file. 


8 Process request to SAVEFLDR a folder to a disk file. 


9 Process request to RESTFLDR a folder from a 
diskette or tape file. 


10 Process request to RESTFLDR a folder from a disk file. 


11 Process request to MOVEFLDR from one location on 
disk to another location. 


12 Terminate this job step. 
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Chart 8.35 Folder Management Services (FMS) Utility Control Flow 
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Interactive Data Definition Utility (IDDU) The following IDDU processes are shown in Chart 


8.36.0: 
The interactive data definition utility (IDDU) allows users 
to define data dictionaries and the disk file definitions 1 Initialize and route control for IDDU processing: 
and communication file definitions they contain. Once 
defined, IDDU definitions are used by Query/36, the ¢ Determine type of call: If procedure, process 
data entry facility, PC Support/36 file transfer, or the data in PPSA; if called by an SVC transfer 
APPC subsystem. instruction, process IDDU parameter list. 
IDDU provides for the following file and dictionary ¢« Store parameter information in IDDU global 
maintenance: area and route control for required processing. 
¢« Define data dictionary. 2 ‘If selected, process for dictionary definition options. 
e Create, update, or delete disk file definitions. 3. =If selected, process for dictionary options. 
¢ Link/unlink disk file definition and disk file label. 4 If selected, process for disk file option to be 


performed on file specified (by label). 
« Enter/update disk file data (via Query /36). 


5 If selected, perform interactive link or unlink disk file 
« Create, update, or delete communications file options. 
definitions. 


6 If selected, perform batch printing. 
IDDU generates internal source that is usable by 


Query/36 or DW/36, without compilation. The data 7 If selected, perform dictionary rebuild. 
definitions built by IDDU are contained in data 
dictionaries. 8 If selected, perform disk file link/unlink. 


A data dictionary is a collection of all definitions related 
to a file, a group of related files, an application, a group 
of related applications, or the entire system. Entries in 
the data dictionary consist of field definitions grouped 
into format definitions, grouped into file definitions. 
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Chart 8.36.0 Interactive Data Definition Utility Overview Control Flow 
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Interactive Data Definition Utility (IDDU) Definition 3. If selected, rebuild dictionary. 
Options Processing 
4 Prompt for, and process, user-specified field 
IDDU definition options processing allows users to options for a definition. 
create or change entries in the data dictionaries. 
5 Prompt for, and process, user-specified format 
The following IDDU definition options processes are options for a definition. 
shown in Chart 8.36.1: 
6 Prompt for, and process, user-specified file options 
1 Prompt for, and process, definition change requests for a definition. 
from user: 
7 Prompt user to select data dictionary name. 
e Get parameter information from IDDU global 
area. 


e Display and process definition-type display. 
e Route control according to options selected. 


e Qn return from specific option processor, 
display definition-type display. 


e If #DSIN was loaded, route control to 
termination; otherwise, return to #DSIN. 


2 Prompt for, and process, data dictionary change 
requests from user. 
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Chart 8.36.1 Interactive Data Definition Utility Definition Options Processing Control Flow 
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Interactive Data Definition Utility (IDDU) Field Options 
Processing 


IDDU field options processing allows users to create or 
change field options for data dictionary entries. 


The following IDDU field options processes are shown 
in Chart 8.36.1.1: 


1 Perform mainline processing, routing control where 
necessary: 


e Display and process options screen. 


e Perform list and recovery processing as 
required. 


e Verify field name to be used in processing. 
¢ Process selected options. 
¢ Return to caller. 


2 Prompt for, and process, user-specified changes to 
a field definition. 


3 Prompt for, and process, field attributes changes. 


4 Prompt for, and process, changes to numeric field 
edit characteristics. 


5 Prompt for, and process, long comment. 
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6 Prompt for, and process, save option and update 
data dictionary with field definition changes 
according to options selected. 

7 Prompt for, and process, copy selection. 


8 Prompt to confirm delete. 


9 Prompt for, and process, print options to be 
performed on the specified definition. 


10 Prompt for, and process, rename options for the 
specified field. 


11 Prompt user to view list of items that were changed 
according to user request(s). 


12 Prompt for creating multiple field definitions. 
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Chart 8.36.1.1 Interactive Data Definition Utility Field Options Processing Control Flow 
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Interactive Data Definition Utility (IDDU) Format Options 6 Prompt for, and process, long comment. 


Processing 
7 Prompt for, and process, save option and update 
IDDU format options processing allows users to create data dictionary with format definition changes 
or change format options for data dictionary entries. according to options selected. 
The following IDDU format options processes are shown 8 Prompt for, and process, copy selection. 


in Chart 8.36.1.2: 


9 Prompt to confirm delete. 
1 Perform mainline processing, routing control where 


necessary: 10 Prompt for, and process, print options to be 


performed on the specified definition. 
e Display and process options screen. 


11 Prompt for, and process, rename options for the 
e Perform list and recovery processing as specified format. 


required. 
12 Prompt user to view list of items that were changed 
e Process selected options. 


e Return to caller. 


2 Prompt for, and process, user-specified changes to 
a format definition, routing control when necessary. 


3 Prompt to verify WHAT-USED table entries for 
specified format definition. 


4 Prompt for, and process, communications attributes 
changes. 


5 Display requested record-ID codes. 
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Chart 8.36.1.2 Interactive Data Definition Utility Format Options Processing Control Flow 
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Interactive Data Definition Utility (IDDU) File Definition 
Options Processing 


IDDU file definition options processing allows users to 
create or change file options for data dictionary entries. 


The following IDDU file options processes are shown in 
Chart 8.36.1.3: 


1 Perform mainline processing, routing control where 
necessary: 


« Display and process options screen. 


¢« Perform list and recovery processing as 
required. 


e« Verify file name to be used in processing. 
« Process selected options. 
e Return to caller. 


2 Prompt for, and process, user-specified changes to 
a file definition. 


3 Prompt to verify WHAT-USED table entries for 
specified file definition. 


4 Prompt for, and process, user specifications for 
long comment. 
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10 


Prompt for, and process, save option and update 
data dictionary with file definition changes according 
to options selected. 

Prompt for, and process, copy selection. 


Prompt to confirm delete. 


Prompt for, and process, print options to be 
performed on the specified definition. 


Prompt for, and process, rename options for the 
specified file. 


Prompt user to view list of items that were changed 
according to user request(s). 
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Chart 8.36.1.3 Interactive Data Definition Utility File Options Processing Control Flow 
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interactive Data Definition Utility (IDDU) Data 
Dictionary Options Processing 


Interactive data definition utility (IDDU) data dictionary 


options processing prompts for and processes the 
following options: 


e (Create data dictionary or security authorization. 


e Revise data dictionary or security authorization. 


¢« Delete data dictionary. 
e Print data dictionary. 


e Rename data dictionary. 
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The following IDDU data dictionary options processes 
are shown in Chart 8.36.2: 


1 Perform mainline dictionary options processing: 

e Verify dictionary name. 

e Display and process dictionary options display, 
provide list, and route control according to 
options selected. 

e Return to caller. 


2 Create new data dictionary. 


3 Change dictionary long/short comment and, if 
selected, dictionary security. 


4 Assign or change dictionary security. 

5 Prompt for, and process, long comment. 
6 Prompt for confirmation of delete request. 
7 Prompt for, and process, print options. 


8 Prompt for, and process, rename options. 
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Chart 8.36.2 Interactive Data Definition Utility Data Dictionary Options Processing Control Flow 
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Interactive Data Definition Utility (IDDU) Disk File The following IDDU disk file label options processes are 


Label Options shown in Chart 8.36.3: 

The interactive data definition utility (IDDU) disk file 1. Perform mainline processing for disk file label 

label options processor prompts for the following disk options: 

file options to be performed on the file specified by the 

label passed in the IDDU global area: e Verify dictionary name. 

e Create disk file. e« Display and process options display, provide 
list, and route control according to options 

e Enter/update data in disk file. selected. 

e Link disk file to file definition. e Return to caller. 

e —Unlink disk file from file definition. 2 Read VTOC and list specified file labels. 


3 Prompt for creation of a new disk file. 
4 Perform requested data entry utility processing. 


5 Prompt for, and process, user-specified options to 
link to a definition. 


6 List data dictionaries and process user selection. 
7 List file definitions and process user selection. 


8 Go to function via command keys. 
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Chart 8.36.3 Interactive Data Definition Utility Disk File Label Options Processing Control Flow 
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Interactive Data Definition Utility (IDDU) Batch Print 
Processing 


Interactive data definition utility (IDDU) batch print 
processing performs all printing specified by IDDU 


users. 


The following IDDU utility batch print processes are 
shown in Chart 8.36.4: 


1 If selected, set up for batch printing: 

« Get DDA information. 

« Allocate and open print file. 

e Route control for required processing according 
to options selected: 
— Print file definitions. 
— Print format definitions. 
— Print field definitions. 

e Return to caller. 


2 Print requested field definitions and return to caller. 


3 Print requested format definitions and return to 
caller. 


4 Print requested file definitions and return to caller. 


5 Retrieve WHERE-USED information on specified 
field, format, or file definition, then return to caller. 


2-406 


This document contains restricted materials of IBM. LY21-0590-4 
©Copyright IBM Corp. 1983, 1984, 1985, 1986 


IDDU Initialization 
and Routing 
(Chart 8.36.0) 


IDDU Field 
Print Routine 
(4DSP1) 


IDDU 
WHERE-USED 
Tracking and 
Control 

(Chart 8.36.9) 


IDDU Format 
Print Routine 
(4DSP2) 


IDDU Batch 
Print 
(4DSBP) 


IDDU File 
Print Routine 
(4DSP3) 


IDDU Print 


Options Display 
(#DSOP) 


$0590433-1 


Chart 8.36.4 Interactive Data Definition Utility Batch Print Processing Control Flow 
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Interactive Data Definition Utility (IDDU) F and | 5 Use global data area and scratch work file passed 
Specification Conversion by #DSZSR to create data dictionary entries, routing 


control where necessary. 
Interactive data definition utility (IDDU) F and | 


specification conversion converts RPG II FILE and INPUT 6 Convert F and | specifications to IDDU definitions, 
specifications into data dictionary definitions. It is routing control where necessary. 
invoked via the IDDUXLAT procedure. 


7 Update data dictionary with field definition changes. 
The following IDDU F and | specification conversion 


processes are shown in Chart 8.36.5: 8 Update data dictionary with format definition 


changes. 
1 Initialize for IDDUXLAT processing: 


9 Update data dictionary with file definition changes. 
e Allocate TWS. 

10 Terminate this job step. 
¢ Build parameter lists in global data area. 


e Get parameters passed with IDDUXLAT 
procedure from PPSA. 


« Verify existence of data dictionary. 
¢ Route control to source processor, #DSZSR. 
2 Process F and | specifications: 
e« Map to global data area set up by #DSZIN. 
¢ Initialize work area and parameter lists. 
e Route control for required processing. 
3 Find and get specified member. 


4 Read source member and create work file. 


2-408 
This document contains restricted materials of IBM. LY21-0590-4 
©Copyright IBM Corp. 1983, 1984, 1985, 1986 


Initiator 


IDDU F and | 
Specification 
Conversion 
(4DSZIN) 


Library Maintenance 
(Chart 8.16.0) 


IDDU Field Exit 
(#DSS1) 


IDDU F and | 

Specification 

Source 

Processing 

(#DSZSR) IDDU Data IDDU F and | 
Dictionary Specification to 
Processing IDDU Conversion 
(#DSZDD) (#DSFI) 


IDDU Format Exit 
(#DSS2) 


IDDU File Exit 


(#DSS3) 


Termination 


$0590437-1 


Chart 8.36.5 Interactive Data Definition Utility F and | Specification Conversion Processing Control Flow 
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Interactive Data Definition Utility (IDDU) Dictionary 
Rebuild 


Interactive data definition utility (IDDU) dictionary rebuild 
rebuilds dictionary definitions. 


The following IDDU dictionary rebuild processes are 
shown in Chart 8.36.6: 


1 Perform dictionary rebuild processing, routing 
control where necessary: 


¢ Get dictionary interlock in DDA. 

e Check that all files in user's list are not in use. 
e Set rebuild in progress flag. 

e Rebuild dictionary definitions. 


2 Generate record-ID code and communications 
format data streams. 


Caller IDDU Dictionary IDDU Format Data 
(Chart 8.36.0 Rebuild Stream Generator 


or 8.36.1) (#DSRB) (#DSG2) 


$0590438-0 
Chart 8.36.6 Interactive Data Definition Utility Dictionary Rebuild Control Flow 
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Interactive Data Definition Utility (IDDU) Common 2 Process security requests for data dictionaries and 


Open their file definitions. 

Interactive data definition utility (IDDU) common open 3 Open specified data dictionary. 
opens data dictionaries and file definitions within them. 

IDDU common open also generates required security for 4 Open specified file definition(s). 


the dictionaries and definitions. Callers invoke common 
open with a transfer SVC instruction and a TMIO 
parameter list. 


The following |DDU common open processes are shown 
in Chart 8.36.7: 


1 Perform open requests for specified data dictionary 
and/or file definitions, routing control where 


necessary: 


e Check TMIO parameter list to determine if caller 
requests read-only or read/write access. 


e Create security key if data management run 
access Is specified. 


¢ Open specified data dictionary. 
¢ Open specified file definition. 


e Return to caller with specified file definition 
opened. 


Resource Security 


Query Data (Chart 8.23.1.0) 
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Chart 8.36.7 Interactive Data Definition Utility Common Open Control Flow 
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Interactive Data Definition Utility (IDDU) Copy 
Options Displays 


Interactive data definition utility (IDDU) copy options 
displays prompt for, and process, copy options for the 
specified field, format, or file definitions. Copy options 
processing for field, format, and file definitions are 
shown in Charts 8.36.8.1, 8.36.8.2, and 8.36.8.3, 
respectively. 


The following IDDU field definitions copy options 
processes are shown in Chart 8.36.8.1: 


1 Prompt for, and process, copy-to selections, routing 
control where necessary: 


e Prompt for, and process, copy-to dictionary 
name. 


e Prompt for, and process, copy-to field 
definition. 


2 Process copy request for definition being copied. 
3 Prompt for, and process, dictionary list selections. 


4 Prompt for, and process, field definition list 
selections. 
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Chart 8.36.8.1 Interactive Data Definition Utility Field Definitions Copy Options Processing Control Flow 


2-412 
This document contains restricted materials of IBM. LY21-0590-4 
©Copyright IBM Corp. 1983, 1984, 1985, 1986 


The following IDDU format definitions copy options 
processes are shown in Chart 8.36.8.2: 


1 Prompt for, and process, copy-to selections, routing 
control where necessary: 


¢ Prompt for, and process, copy-to dictionary 
name. 


« Prompt for, and process, copy-to format 
definition. 


2 Prompt for copy option and process copy request 
for format definition. 


3 Prompt for, and process, dictionary list selections. 


4 Prompt for, and process, format definition list 
selections. 


5 Copy fields used by format definition. 
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Chart 8.36.8.2 Interactive Data Definition Utility Format Definitions Copy Options Processing Control Flow 
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The following IDDU file definitions copy options 
processes are shown in Chart 8.36.8.3: 


1 Prompt for, and process, copy-to selections, routing 
control where necessary: 


¢ Prompt for, and process, copy-to dictionary 
name. 


e Prompt for, and process, copy-to file definition. 


2 Prompt for copy option and process copy request 
for file definition. 


3 Prompt for, and process, dictionary list selections. 


4 Prompt for, and process, file definition list 
selections. 


5 Copy fields and formats used by file definition. 
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Chart 8.36.8.3 Interactive Data Definition Utility File Definitions Copy Options Processing Control Flow 
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Interactive Data Definition Utility (IDDU) 
WHERE-USED Tracking and Control 


Interactive data definition utility (IDDU) WHERE-USED 
tracking and control maintains the WHERE-USED 
cross-reference directories for all dictionary definitions. 
When field, format, or file definitions are changed, 
#DSWU is called to confirm that the change will not 
cause errors in higher-level definitions and to make 
appropriate changes to those higher-level definitions. 


The following IDDU WHERE-USED tracking and control 
processes are shown in Chart 8.36.9: 


1 Process WHERE-USED options requested, routing 
control where necessary: 


e Search for affected definitions and labels and 
maintain affected items records. 


e Perform verification processing as requested. 
e Perform mark operations as requested. 
2 Retrieve list of affected labels. 


3 Verify that changes made to specified definition will 
not cause errors in affected items. 


4 Mark affected items, as requested. 
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Diagnostic Diskette Copy Utility 
The diagnostic diskette copy utility copies all sectors 
(except sectors 3, 5, and 6 on cylinder 0, head O) of 


diagnostic formatted diskettes. 


The following diagnostic diskette copy utility processes 
are shown in Chart 8.37: 


1 Perform or route for diskette copying requested. 
2 Allocate diskette drive. 

3 Prepare diskette for copy. 

4 Copy all sectors from diskette to disk. 

5 Copy all sectors from disk to output diskette. 

6  \ssue error messages. 


7 Terminate program. 


Initiator 


2 Allocate 


Diagnostic Diskette Diskette l|OS 
Copy 
(SDCOPY) 

6 SYSLOG 


Chart 8.37 Diagnostic Diskette Copy Utility Control Flow 
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Data Communications Function - X21 Chart 9.4.0 


The data communications function provides the user > Autocall Chart 9.5 


with the communications line protocols and other 
detailed functions needed to use the System/36 SSP * Remote work station support Chart 9.6.0 
data communications higher-level programming features. 


It includes the following functions: ° — Link station test Chart 9.7 

- Batch BSC Chart 9.1.n e X.25 Chart 9.8.0 
¢ SDLC Chart 9.2.0 ¢ Display Station Pass-Through Chart 9.9.1 

- MLCA/ELCA controller check Chart 9.3.1 * Support of the local area Chart 9.10.0 


handler network (LAN) 


User Open Request SSP Common 
via Transfer SVC Open 
Instruction with DTF EI 


BSC Open 


(Chart 9.1.1) 


BSC Data 
Management 


User Request (Chart 9.1.1) 


via DTF 


SSP-ICF Data 
Management 


C/SNA, Peer and 
Finance Subsystems 


Data Link Control 
SDLC 
RWS (Chart 9.2.0) 
(Chart 9.6.0) or 
X.25 
(Chart 9.8.0) 


User Requests via 
WSDM or Printer 
Data Management 


Link Station 


Test 
(Chart 9.7) 


User Request via 
Screen Formats 


(Chart 9.10.0) 


User Close Request SSP Common BSC Close 
via Transfer SVC Close (Chart 9.1.4) 
Instruction with DTF 


X.21 
(Chart 9.4.0) 


BSC and SDLC 
Link Controls 


Autocall Task 
(Chart 9.5) 
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Chart 9.0 Data Communications Overview Control Flow 


2-418 
This document contains restricted materials of IBM. LY21-0590-4 
©Copyright IBM Corp. 1983, 1984, 1985, 1986 


BATCH BSC SUBFUNCTION 


The batch BSC subfunction provides the RPG II or 
assembler language user with the support necessary to 
use the communications adapter to transmit and receive 
data over communications lines to and from other 
systems or terminals. For information on batch BSC line 
protocols, refer to Appendix A: Data Communications 
Line Protocols. 


Batch BSC consists of a data management module, a 
main storage interrupt handler module (running as a 
separate task), and several transients. The user program 
interfaces directly with the BSC data management 
module via the transfer SVC instruction. XR2 points to 
the user program DTF, which points to the logical 
buffer. 


Other interface information needed by the BSC task is 
contained in the communications specifications block 
(CSB). The System/36 initiator (see Command Processor 
Ef) builds the CSB according to the following input: 


e Communications configuration record 


e The commands associated with the BSC-invoking 
procedure 


e The parameters passed in the BSC-invoking 
procedure 


The batch BSC subfunction performs the following: 


e Open and initialize to Chart 9.1.1 
establish line control 

e Put user data to line Chart 9.1.2.1 

e Get user data from line Chart 9.1.2.2 

e Process waits, posts, op ends, Chart 9.1.3 
and error recovery 

e Close and terminate Chart 9.1.4 
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Open and initialize processing includes: 


1 


Open the BSC DTFs and alter them based on 
user-specified parameters in the ALTERCOM 
procedure. 

Open the CSB (communications specification block) 
and assign the line buffers in SQS, or SWS if 
greater than 2K bytes and line work area (in SQS). 


If an active DTF is in process, call BSC close. 


Format the |/O area into IOBs, line buffers, and 
switched IDs. 


Enable the communications adapter (by calling 
control storage BSC code to bring up data terminal 
ready and dataset ready). 

Initialize the lines by sending or receiving enquiry. 


Start communications on the BSC line(s). 


Route for any required error messages. 
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Batch BSC Interrupt Handler Region Map 


The following table shows the locations of key data 
areas associated with the batch BSC interrupt handler: 


Dump 
Address 
(in Hex) 


0800 
1000 BSC transients 
2000 Batch BSC interrupt handler (#BSCM) 


8000 First line buffers (if greater than 2K 
bytes) 


AO0O Second line buffers (if greater than 2K 
bytes) 


Co00 Third line buffers (if greater than 2K 
bytes) 


Fourth line buffers (if greater than 2K 
bytes) 
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Batch BSC Data Management Region Map 


The following table shows the locations of key data 
areas associated with batch BSC data management: 


Dump 
Address 
(in Hex) 


0900 Nucleus 
Batch BSC data management 
subroutines (#BSDB) 

2000 User DTF or user buffer 


8000 First line buffers (if greater than 2K 
bytes) 


Second line buffers (if greater than 2K 
bytes) 


Third line buffers (if greater than 2K 
bytes) 


Fourth line buffers (if greater than 2K 
bytes) 
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User Open Request 
via Transfer SVC 
Instruction using DTF 


Common Open 


BSC Open 


Transient 
(#BSOB) 


User Initial Put/Get 
Request via DTF 


BSC Data Management 
Subroutines 
(#BSDB) 


Data Management 
Mainline Subroutine 


BSC Message 
Handler 
(#BSMD) 


BSC Mainline 


BSC Line 
Initialization 
Transient 
(#BSLO) 


Close (Chart 9.1.4) 


Point-to-Point 
Nonswitched 
Line 
Initialization 
(#BSL4) 


Switched 
Line Answer 
Initialization 
(#BSL3) 


(#BSDM) (#BSCM) 


Switched 
Line Calling 
Initialization 
(#BSL2) 


Data Management Line Initialization 
Post Subroutine Mainline 
(#BSPOST) (#BSLI) 


Data Management 
Wait Subroutine 
(#BSIW) 


Post Subroutine 
(#BSPOST) 


Exit-to-User NSI 
Subroutine 
(#BSEXIT) 


Multipoint Line 

Initialization 

(#BSCKRI) Autocall X.21 
(Chart 9.5) (#GC21) 
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Put-user-data-to-line processing includes: 4 Insert start of text (STX) and record separator (if 
specified) control characters and compress or 
1 Wait until previous transfer completes, then check truncate blanks if specified. 
1OB completion code. 
5 Insert end-of-text block (ETB) and end-of-text 
2 Determine from DTF the operation request and block (ETX) for last record line control characters. 
route for the following: 
6 Transmit data, by block, to the receiving station. 
3 Move data, by record, from user's logical buffer to 
an available line buffer and format (block if 7 ~~ Exit to requesting task. 
specified) for line transmission. 


User Requests via 
Transfer SVC Instruction 
with XR2 = DTF 


BSC Data Management Subroutines 
(#BSDB) 


1 
Put Blocking Blank Compression 
Subroutine Subroutine 


(#BSMP) 1 (#BSCP) 


BSC Data 
Management 
for Get/ Put 
Subroutine 
(#BSDM) 


Data Management 
Move Subroutine 
(#BSMO) 


BSC Wait 
Subroutine 
(A4BSIW) 


BSC Interrupt 


Handler Task 
(#BSCM) 
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Chart 9.1.2.1 BSC Put-User-Data-to-Line Control Flow 
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Get-user-data-from-line processing includes: 


1 Determine from DTF the operation request and 
route for the following: 


2 Wait until data transfer is completed, then check 
IOB completion code. 


3 Strip off control characters, move data (by 
deblocked record) from line buffer to user's logical 
buffer (inserting blanks), and format for receive. 


4 Exit to requesting task. 


User Requests via 
Transfer SVC Instruction 
with XR2 a DTF 


BSC Data Management Subroutines 
(#BSDB) 


Data Management 
Move Subroutine 
| 
| 


| | 

| I 

| I 

I | 

I | 

! | (#BSMO) 

| I SSS S 3 Pape pp ea gt ree age ee ape ey By Re ne ae 

| 3 

BSC Data ; } 

| I (SS SS SSeS SS SS ees (S33 See 4 = eSSS S55 
M t 

: eae : 31 Get Deblocking 1 3; Blank Expansion ! 

: Pa SONEEs aa ‘=> = Subroutine => = Subroutine | 

I l 

! (#BSDM) Fa Rin ae ee ! 

| } 

| 1 21 BSC Wait ! 

; i, Subroutine 

(#BSIW) 
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Chart 9.1.2.2 BSC Get-User-Data-from-Line Control Flow 
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Wait, post, op-end, and error recovery processing 
includes: 


Wait for data transfer and check IOB completion 
code. 


Check all BSC operations for errors and perform any 
required error routing; if unrecoverable (permanent) 
error occurs when user requests BSC close, disable 
the line by calling control storage BSC code to drop 
data terminal ready and dataset ready. 


Check for line buffer ready-for-data-transfer, and 
call control storage BSC code as required. 


If multipoint, respond negatively to host select or 
polls, while waiting for user. 


Control Storage 


Program Op-Ends 


BSC (Main Storage) Interrupt Handler Subroutines 


1 (#BSCM) 


I 


Operation End 
Processing 
Subroutine 
(#BSHB) 


Wait Subroutine 
(#BSIW) 


BSC Data 
Management 


8,9,11 
Subroutines 
(Chart 9.1.2) 


~ 


10 


11 


| 


toe 


If trace active, trace each op-end from control 
storage. 


Issue required error messages. 

Log permanent errors to system ERAP table. 

If RPG Il application program, return user-specified 
modification of return code. If error, set permanent 


error indicator. 


If assembler language application program, issue 
return code in DTF. 


Process user end-of-job or close request. 


Post BSC data management task. 


Control Storage 


ome os i i i i i is ii ws = 


BSC 10S ) 
Subroutine I 
(#BSIO) | 

I 


Send EOT 1 
Subroutine I 
(#BSMPEOT) 


t 
Receive Initial ! 
Initiator Subroutine | 
(HBSAUTO) ! 


10. Close 
(Chart 9.1.4) 


BSC Message 


Handler 
(#BSMD) 


System Logging 


Utility 
(4CMWO) 
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Chart 9.1.3 BSC Op-end, Wait, Post, and Error Recovery Control Flow 
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Close and terminate includes: 
Note: Items 5 through 8, below, are performed by 
#BSCL if normal termination or #BSER if abnormal 


termination. 


1 Route BSC close requests to BSC data 
management. 


2 Post the interrupt handler with the close or 
terminate request. 


3 Route close request to BSC close transient. 


4 If close request, complete processing of any put-file 
data still in |/O buffers and reset open flags in DTF. 


(from Charts 9.1.1 and 9.1.3) 


User Requests via 


Transfer SVC 
Instruction 


BSC Data 


Management 
(#BSDB) 


Common Close 


Batch BSC 
(Main Storage) 


(#BSCM) 
Termination 


Termination 
(A4BSER) 


Chart 9.1.4 BSC Close and Terminate Control Flow 
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Interrupt Handler 


BSC Abnormal 


Disable communications line by calling control 
storage code to drop data terminal ready and 
dataset ready. 


In ERAP, log text sent, text received, and error 
counters accumulated. 


Free |/O areas and line work area. 
If last BSC user, terminate task. 


For abnormal termination, also log error and display 
messages to BSC users. 


Control Storage 


BSC Close 
Transient 
(#BSCL) 


4,5,6,7,8 


System Logging 
Utility 
(4CMWO) 


BSC Message 
Transient 


(#4BSMD) 
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SYNCHRONOUS DATA LINK CONTROL (SDLC) The following SNA tasks are users of primary SDLC: 
SUBFUNCTION 


¢ Remote work station support (Chart 9.6.0) 
Synchronous data link control (SDLC) is a 


communications protocol designed to manage ¢ SSP-ICF Finance subsystem i 

information transfer between buffered stations, on a 

data transmission link that has a centralized control. The ¢ SSP-ICF Peer subsystem 1.0 

SDLC is the standard line control discipline for the 

systems network architecture (SNA). e Link station test (Chart 9.7) 

System/36 can exist in an SDLC data link as both a « C/SNA 10 (for the APPC subsystem) 

primary and a secondary station (on separate lines). As 

a primary station, System/36 sends commands to, and The following SNA tasks are users of secondary SDLC: 
receives responses from, its secondary stations. As a 

secondary station, System/36 responds to the ¢ SSP-ICF Peer subsystem 1 | 


commands sent from the primary station. 
e C/SNA 10 (handles SDLC requests for the MSRJE 


Unlike the BSC protocol which can stand alone given a subsystem, the SNUF subsystem, the APPC 
user-program-DTF interface, the SDLC protocol subsystem, and the SNA 3270 device emulation 
operates one programming layer below, at the IOB subsystem) 


interface level. This means the user application should 

be interfacing (at the DTF level) to the applicable SNA 

task, to printer data management or work station data 

management in the case of remote work stations, or to 
a user-provided, equivalent task. 


All communication from SDLC tasks to control storage 
is done via IOBs on the line and transmit queues. The 
control storage SDLC microcode removes IOBs from the 
line queues and posts them to the SDLC tasks when the 
requested operations are completed. 


The synchronous data link control subfunction also 
includes the application program interface to X.25 and 
support of the LAN. The SNA to data link control (DLC) 
resident interface (#SDRI) receives IOBs from application 
programs, determines whether the IOBs are intended for 
SDLC, X.25, or LAN, then routes them via 
post-task-by-ID SVC instructions to the appropriate data 
link control module. This control flow is not shown in 
Chart 9.2.0, but is shown in Chart 9.2.3. 


Note: All charts describing the SDLC components use 
the general term ‘Applicable SNA task’ to refer to other 
SSP components running above SDLC. 
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Chart 9.2.0 shows the overview control flow for SDLC: 


Applicable 
SNA Task Primary SDLC, 
SLCA, or 
SDLC Tasks MLCA/ELCA 
Data Communications Microcode 
Allocate Secondary SDLC, 
| SLCA, or 
| MLCA/ELCA 
l Microcode 
L 
Line Queue 


Transmit Queue 


$0590320-1 


Chart 9.2.0 SDLC Overview Control Flow 


Section 2: Data Communications Function Ei 2-427 
This document contains restricted materials of IBM. LY21-0590-4 
©Copyright IBM Corp. 1983, 1984, 1985, 1986 


SDLC uses four data areas in processing IOBs: SDLC consists of four basic parts: 


There is a communications specification block (CSB) for « SDLC initialization and Charts 9.2.1.1 

each line used by SDLC. Each CSB has a CSB termination subtask and 9.2.1.2 

extension called the common area that contains status 

information for the respective line. e Mainline SDLC subtask Charts 9.2.2.1 
and 9.2.2.2 

The poll list contains entries for each of the stations 

with which SDLC is communicating. It is pointed to by e SNA-to-data link control Chart 9.2.3 

the CSB. The poll list contains one group or control interface 

entry for each SNA using the line. The group entries are 

chained together. Following each group, is One or more e SDLC abnormal termination Chart 9.2.4 

station entries, each of which describes the status and routines 


contains the transmit queue for a remote station. 


When an SNA task issues the line open operation, SDLC Initialization and Termination Subtask 
SDLC builds new group and station entries in the poll 
list. When mainline SDLC issues a start auto-poll or The SDLC initialization/termination subtask performs 
auto response command, the control storage SDLC SDLC initialization and termination processing, as well 
microcode begins monitoring fields in the poll list that as message handling for SDLC. It is a swappable 
indicate whether to slow poll, normal poll, stop scanning subtask that performs both SDLC primary and SDLC 
the poll list (transmit |OB found), or continue monitoring secondary processing. 
the poll list. 

The following SDLC intialization processes are shown in 
The transmit queue, contained within the poll list, holds Chart 9.2.1.1: 
lIOBs to be transmitted and IOBs that have been 
transmitted but not yet verified by Nr-Ns counts. There 1 Perform initial processing of open request: 
is one transmit queue chained to each station entry in 
the poll list. |OBs are moved to/from the transmit e Get resident SNA-to-SDLC interface loaded 
queue by the SNA-to-SDLC interface and by mainline (#SDRI contains code that loads the resident 
SDLC. interface routine). 
The line queue contains all IOBs issued to the SDLC e Attach mainline SDLC task as a subtask. 
control storage microcode. The line queues (one per 
line) are contained in SCA and are pointed to by queue e Build poll list group entry and post mainline 
headers. task to add group to poll list. 
Note: An IOB on the transmit or line queue causes 2 Allocate line and CSB, and assign poll list and |IOBs. 
control flow to or from control storage, as shown in 
Chart 9.2.0. In subsequent SDLC control flow charts, 3 Return SDLC line open parameter list complete. 
these queues and the poll list (which contains the 
transmit queue) are shown receiving and passing 4 Process transmit [OB containing enable command. 
control; this is done to simplify the control flow chart 
and should in no way imply that the queues contain 5 If switched line, issue manual call or manual answer 
free-standing, executable code. message. 


6 Process enable command, returning data terminal 
ready and data set ready. 


7 If data set ready not on, (data set not ready), issue 
message. 
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8 If autocall, establish autocall connection and post 12 Process transmit |OB containing open station 
task. command (primary SDLC only) and initialize station 
entry in the poll list. 
9 Process enable post from initialization /termination 
by initializing fields in the poll list. 13 Process returned IOB containing open station 
command complete. 
10 Return enabling |OB, indicating operation is 
complete. 14 At any time in above sequence, process errors 
requiring abnormal termination. 


11 Process receive IOBs and start-autopoll |OB (control 
storage processes these IOBs placed on line queue 
by #SDLC). 


2 Data Communications 
Allocate 


SNA-to-SDLC 
5,7 


Resident Interface 
(Chart 9.2.3) 12 


SYSLOG 


SDLC Initialization 
Termination Subtask 
(#SDIT) 


Autocall Task 
(Chart 9.4.1 or 
Chart 9.5) 


Applicable 
SNA Task 


Poll List 
Group Entry 


SDLC Abnormal 
Termination Routines 
(Chart 9.2.4) 


Station Entry 


Line Queue 
Mainline SDLC 


Subtask 
(#SDLC) 
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Chart 9.2.1.1 SDLC Initialization Control Flow 
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The following SDLC termination processes are shown in 
event sequence in Chart 9.2.1.2: 


1 Process terminate-detach |OB command. 
2 Stop auto-poll. 


3 Stop auto-poll posted complete followed by start 
auto-poll complete. 


4 Remove all transmit IOBs from the transmit queue 
and return them to the SNA task with completion 


codes of request ignored. 


5 Remove poll list group from the queue and queue it 
to the terminate IOB. 


6 Give terminate IOB to initialization/termination task. 
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11 


12 


Perform disable processing: 
e Disable adapter. 
« Clear receive IOBs from the line queue. 


« If permanent handware error, put wrap test |OB 
on line queue and wait for its completion. 


Where appropriate issue message based on wrap 
test results. 


Process terminate/detach IOB returned from SDLC. 
Perform any required error logging. 
Deallocate line. 


At any time in above sequence, process errors 
requiring abnormal termination. 
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SNA to SDLC 
Interface 
(Chart 9.2.3) 


Poll List 


Mainline SDLC 
Subtask 
(#SDLC) 


Transmit Queue 


Applicable 


SNA 
Task 


Line Queue 


8 SYSLOG 


SDLC 
Initialization / 


Termination 
(#SDIT) 


Data Communications 
Allocate 


12| SDLC Abnormal 
Termination Routines 


(Chart 9.2.4) 
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Chart 9.2.1.2 SDLC Termination Control Flow 
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Mainline SDLC Subtask 


The mainline SDLC subtask performs transmit and 
receive operations for the requesting task. It is a 
resident nonswappable subtask that performs both 
SDLC primary and SDLC secondary processing. 


The following mainline SDLC subtask receive processes 
are shown in event sequence in Chart 9.2.2.1: 


1 Process receive |OB posted complete (possibly with 
an error) by control storage. 


2 Post receive IOB with data (or with permanent 
hardware error). 


3 Return receive !OB to line queue. 


Mainline SDLC 
Subtask 


Applicable (#SDLC) 


SNA Line Queue 


mask SNA-to-DLC 


Interface 
(Chart 9.2.3) 


$0590323-0 
Chart 9.2.2.1 Mainline SDLC Subtask Receive Control Flow 


2-432 
This document contains restricted materials of IBM. LY21-0590-4 
©Copyright IBM Corp. 1983, 1984, 1985, 1986 


The following mainline SDLC subtask transmit processes 
are shown in event sequence in Chart 9.2.2.2: 


1 Queue transmit IOB to transmit queue. 


2 Process start-auto poll complete post (internal IOB) 
from microcode. 


3 Put transmit IOB on line queue. 


4 After response is received from remote system or 
controller, process transmit |OB complete post from 
microcode by verifying, removing it from the 
transmit queue, and returning it to the SNA task. 


5 If required, log hardware errors returned by SDLC 
microcode. 


SNA-to-DLC 
Interface 
(Chart 9.2.3) 


Transmit Queue 


Applicable 


SNA 
Task 


Line Queue 


Mainline SDLC 
Subtask 
(#SDLC) 
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Chart 9.2.2.2 Mainline SDLC Subtask Control Flow 


Section 2: Data Communications Function 9 | 2-433 
This document contains restricted materials of IBM. LY21-O0590-4 


©Copyright IBM Corp. 1983, 1984, 1985, 1986 


This page is intentionally left blank. 


2-434 
This document contains restricted materials of IBM. LY21-0590-4 
©Copyright IBM Corp. 1983, 1984, 1985, 1986 


SNA-to-DLC Interface 


The SNA-to-DLC interface routes all requests from 
applicable SNA tasks to one of the data link controls. It 
receives IOBs from SNA tasks, determines whether the 
lOBs are intended for SDLC, X.25, or support for the 
local area network (LAN), then routes them via 
post-task-by-ID, communications IOCH, IOCH for the 
LAN, or queue SVC instructions to the appropriate data 
link control module. Because it routes all X.25 IOBs 
directly to X.25 mainline (#XTML) regardless of the 
function requested, this topic describes control flow for 
SDLC and support for the LAN only. 


SNA initiates communication with SDLC or support for 
the LAN by issuing an SDLC line open parameter list. 
The parameter list is posted to the initialization/ 
termination task, #SDIT or #LNIT, which calls 
SNA-to-DLC interface, #SDRI. #SDRI loads a section of 
code called the Resident Interface which remains in main 
storage as long as SDLC or support for the LAN is 
active. All IOBs issued by the SNA are given to the 
resident interface. The resident interface routes the IOBs 
to the appropriate function via post-task-by-ID, queue, 
communications IOCH, or IOCH for the LAN SVC 
instructions. 


SNA-to-SDLC Interface Posting: The SNA-to-DLC 
interface (ZSDRI) posts various components dependent 
on the type of IOB issued and the conditions under 
which the IOB was issued. The following chart 
summarizes the posting variations: 


IOB, |OB Operation | SNA 
Code, or Task 
Completion Code Posted 


#SDLC 
Posted 


#SDIT 
Posted 


Unrecognized 
operation 


Invalid write 


No poll list entry 
found 


SNRM ERROR 
RESET 


DISC 


TERMINATE or 
TERMINATE/ 
DETACH 


No poll list segment 
found 


Internal lIOBs 


ENABLE and OPEN 
station 


Station not 
operational 


Receive IOBs with 
permanent error 


Recefve IOBs 
without line enabled 


Section 2: Data Communications Function 9 | 2-435 


This document contains restricted materials of IBM. LY21-0590-4 


©Copyright IBM Corp. 1983, 1984, 1985, 1986 


SNA-to-LAN Interface Posting: The SNA-to-DLC 


interface (#SDRI) posts various components dependent 


on the type of IOB issued and the conditions under 
which the IOB was issued. The following chart 
summarizes the posting variations: 


IOB, IOB Operation | SNA IOB 
Code, or Completion| Task Queued to 


Posted | Line Queue |Posted 


Unrecognized 
operation 


No SNA list found 


ENABLE is in 
process 


Permanent link 
(network) error 


ENABLE !OB issued 
by SNA 


TERMINATE or 
TERMINATE/ 
DETACH 


OPEN station 


Read IOB (ordinary) 


Read IOB (internal) 


(queued 
to CSB) 


SNRM, DISC/ 
REQDISC, SNRM 
ERROR RESET 


XID and Test 


Ordinary transmit 
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The following SNA-to-SDLC interface processes are 
shown in event sequence in Chart 9.2.3: 


1 Process all IOBs from SNA: 
e If invalid request, return it immediately. 
e If X.25 request, post it to X.25 mainline task. 
e If SDLC request, route appropriately. 


2 Process posted internal IOBs and the following 
posted requests: 


e Receive IOBs with errors. 
¢« Disconnect/Request Disconnect. 
¢ Terminate /Detach. 
e SNRM Error Reset. 
3 Process all X.25 IOBs. 


4 Process normal transmit IOBs (SNRM, XID, TEST, 
or WRITE opcodes) queued by #SDRI. 


5 Process normal receive IOBs placed on queue by 
#SDRI via the communications IOCH SVC 
instruction. 

6 Process enable and open station SNA IOB opcodes. 


7 Process the following: 


e Enable and open station SNA IOB opcodes for 
LAN. 


e Disconnect/Request Disconnect. 
¢ Terminate. 

¢ Terminate/Detach. 

¢ Error return code from IOCH. 

¢ Pended XIDs from IOCH. 


8 Process normal transmit IOBs for LAN. 
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Applicable 1 


SNA 
Task 


SNA-to-DLC 
Interface 


(#SDRI) 


Chart 9.2.3 SNA-to-DLC Interface Control Flow 
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SDLC Mainline 
Task 
(Chart 9.2.2) 


3 X.25 Mainline 
Task 
(Chart 9.8.2) 


Transmit Queue 


Line Queue 


SDLC 

6 Initialization / 
Termination 
Task 
(Chart 9.2.1.n) 


7 Initialization / Termination 
Task of the LAN 
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SDLC Abnormal Termination The following abnormal termination processes are 


shown in Chart 9.2.4: 
SDLC abnormal termination receives control for the 


following errors: 1 Disable adapter(s) and clear line queue(s). 

e MLCA/ELCA controller check 2 Return any transmit |OBs with abnormal completion 
codes. If no transmit IOBs exist, post the SNA with 

e 2K-page failure an internal |OB indicating abnormal termination 
condition. 


e SDLC task abnormal termination 


3 Post terminate/detach IOB to #SDAM. 
Abnormal termination can be evoked from SDLC 


initialization/termination or from SDLC mainline. if 4 Post terminate/detach IOB to #SDAT. 

SDLC mainline (ZSDLC) encounters or detects an error, 

control storage termination loads abnormal termination 5 Process for terminate /detach. 

for mainline (ZSDAM) over SDLC mainline. Similarly, if 

SDLC initialization/termination (#SDIT) encounters or 6 Return terminate/detach IOB and go to end of job. 


detects an error, control storage termination loads 
abnormal termination for initialization /termination 
(HSDAT). Whichever abnormal termination routine gets 
control initially, it notifies the other, normally running 
task, and that task forces (via control storage 
termination) the loading of its respective abnormal 
termination routine. In either case, #SDAM has replaced 
#SDLC and #SDAT has replaced #SDIT before abnormal 
termination processing begins. 


Abnormal 
Termination 
for Mainline 
(4SDAM) 


SNA-to-DLC 
Resident Interface 
(Chart 9.2.3) 


Applicable 
SNA 
Task 


Abnormal 
Termination for 
Initialization / 
Termination 
(#SDAT) 


Line Queue 
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Chart 9.2.4 SDLC Abnormal Termination Transient Control Flow 
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MULTILINE COMMUNICATIONS ATTACHMENT/ 
EIGHT LINE COMMUNICATIONS ATTACHMENT 
(MLCA/ELCA) SUPPORT SUBFUNCTION 


Most of the main storage multiline and eight line 
communications attachment support is coded into the 
system programs using the MLCA/ELCA. The support 
makes the detail programming required in maintaining 
multiline communications transparent to the user. User 
applications need only specify the line number to use the 
MLCA/ELCA. 


The only SSP modules totally dedicated to the 
MLCA/ELCA are the MLCA/ELCA controller recovery 
module and the MLCA/ELCA controller check handler. 
The controller check handler executes a wrap test to 
determine the nature and extent of the adapter or 
microcode problem, then it reports the severity of the 
problem to all active communications tasks. 


MLCA/ELCA IOCH Command Processor 
(Microcode) Error Processing 


Posts Command Transient 
Processor with Error 2 | 


The following MLCA/ELCA controller check handler 
processes are shown in Chart 9.3.1: 


1 


2 


Chart 9.3.1 MLCA/ELCA Controller Check Handling Control Flow 
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Attach controller check handler. 
Load MLCA/ELCA control storage wrap test. 


Issue wrap test IOB and display message containing 
system reference code to system console. 


Post the wrap test results to all data 
communications link controller tasks that have an 
active IOB. 


Reload the MLCA/ELCA control storage I/O control 
handler programs. 


1 MLCA/ELCA 
Controller Recovery 
(#MLCT) 


2,3,4 


MLCA/ELCA Controller 
Check Handler 
(H#MLCK) 


Communications 
Allocate 


$0590028-1 


Section 2: Data Communications Function 9 | 2-439 


X.21 SUPPORT SUBFUNCTION 


X.21 support consists of the SSP data communications 
programming that permits System/36 to be attached to 
an X.21 Public Data Network. 


The following capabilities are provided: 


« Automatic calling of remote DTEs that have 
subscribed to the X.21 network and status retrieval 
of each call (via the X.21 network call progress 
signal). 


« Registration for, and cancellation of, user facilities 
offered by the X.21 Public Data Network. 


« Creation of X.21 connection lists that contain the 
public data network addresses of the remote DTEs 
to be called. 


X.21 support consists of an autocall program (#GC21), 
an error processing transient (#GCAT), and two utilities 
(4GCFR and $XNLM) evoked by the REQUESTX and 
DEFINX21 procedures. 


User Requests from X.21 Support 


Work Station Keyboard: 


X.21 Phone List 
Load-Module 
Builder 
(Chart 9.4.3) 


eee eee eee i ie oe 


DEFINX21 


— we oe we mw im ie ww ome ee wm mm we ie we oe oe oe = == iw ow = i ww iw im ee = = = = 


Dynamic 


#GCFR ABTERM 


| | 

! ! 

Reaistrati I i 

eer cone = Transient | 
Cancellation Task ; (GCAT) | 

(Chart 9.4.2) I I ! 


eee i ae ee == — ee em ee ow we ie = = = — ee i i i i we = = 


MSRJE, ICF, or 
Batch BSC Interrupt 
Handlers with X.21 

Phone List 
or 
SDLC with X.27 0 Pe em se 
Phone List 


X.21 Autocall Task 
(Chart 9.4.1) 


To X.21 Switched 
Public Data Network 
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Chart 9.4.0 X.21 Support Overview Control Flow 
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X.21 Autocall 


The X.21 autocall task is the interface between the 
communications microcode and the protocol link control 
modules (which function as main storage interrupt 
handlers) attempting to establish communications in an 
X.21 circuit-switched Public Data Network. In addition 
to placing the call, the autocall task also monitors and 
displays the status of each call. After the data link is 
established, the X.21 autocall task is swapped to disk 
until the next call request is issued. 


The X.21 autocall task supports up to eight X.21 circuit- 
switched lines. The link control modules (which function 
aS main storage interrupt handlers) invoke the autocall 
task by issuing post task with ID SVC instructions with 
XR1 pointed at the IOB (the IOB points to the connection 
list). 


Register For/Cancel 23 
User Facility 
(Chart 9.4.2) 


X.21 Autocall 
Task 


Requests from (#GC21) 


Protocol Link 
Controls: 2,3,4 


MSRJE BSC 
ICF BSC 
Batch BSC 
SDLC 


Chart 9.4.1 X.21 Autocall Control Flow 


The following X.21 autocall task processes are shown in 
Chart 9.4.1: 


1 Initialize X.21 Communications at IPL. 

2 Perform dial requests received from protocol link 
control modules and maintain status of connection 
list. 


3 Post the caller successful or unsuccessful. 


4 Process reset requests by resetting the status of the 
call and posting the request complete. 


1 Data Communications 
Allocate 


2 SYSLOG 


Control Storage 


Error Logging, 
MLCA/ELCA, 


and X.21 
Microcode 
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X.21 REQUESTX Utility The following REQUESTX utility processes are shown in 


Chart 9.4.2: 
The X.21 REQUESTX utility allows an X.21 user to 
dynamically register for and cancel network facilities 1. Read utility control statements. 
provided by the Public Data Network. Depending on the 
network requirements, some facilities may be registered 2 Initialize for utility: 


for at subscription time, while others may be registered 
for or canceled at the time the service is actually 
needed. This utility was originally provided for 
subscribers in Japan using the DDX 
circuit-switched-network Closed User Group facility. It 
is expected that this utility will be usable in other 
countries whose X.21 networks are still in various stages 
of development. 


After the REQUESTX utility is invoked, 3 
registration/cancellation sequences can be initiated from 

a work station or a source member. The sequences are 
contained in source records that specify the line number 

on which the requests are to be transmitted. On 

receiving the request, the REQUESTX utility points XR1 

at its |OB and posts the X.21 autocall task to transmit 

the request. The IOB points to the X.21 connection list 
containing the facility sequence. 
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Read communications configuration record. 
Assign data areas. 
Print output or issue message. 


Initialize X.21 connection list. 


Perform source facility requests. 


Read source record from source member or 
work station device. 


Validate information. 

Allocate and enable line. 

Set up IOB and X.21 connection list. 
Post X.21 autocall task. 


Print output or issue message. 


Terminate for utility: 


Deallocate and disable line. 


Free utility-assigned data areas. 


Perform inquiry and cancel functions: 


Deallocate and disable X.21 line(s). 


Free X.21 active data areas. 
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Task 
(Chart 9.4.1) 
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Chart 9.4.2 X.21 REQUESTX Control Flow 
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X.21 DEFINX21 Utility 

The X.21 DEFINX21 utility allows an X.21 user to create 
and alter connection lists of X.21 Public Data Network 
numbers or X.21 short hold mode (SHM) line 
configurations. DEFINX21 is an interactive utility that 
takes data from the work station and places it in a library 
as an object member. 

The following DEFINX21 utility processes to create or 
alter an X.21 connection list are shown in Chart 9.4.3: 

1 Display prompts and read input. 

2 Verify data and find specified library. 


3 Build phone list load module on disk. 


4 Terminate for utility. 


Initiator 


Work Station 


1 
Data Management 
2 
Find a Library 
X.21 Phone 3 Library Sector 6 | 


List Load 
Module Builder 
(SXNLM) 


Put/Get 


SYSLOG 


System Terminate 
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Chart 9.4.3 DEFINX21 Control Flow 
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X.21 DEFINX21 SHM Line Configuration Utility 

The following DEFINX21 utility processes, that create or 
alter an X.21 SHM line configuration, are shown in 
Chart 9.4.4: 


1. Display prompts and read input. 


2 Verify data and find library and member, protect 
member, and read member. 


3 Build X.21 SHM line configuration load module on 
disk. 


4 Print X.21 SHM line configuration. 


5 Terminate for utility. 


Initiator 


1 Work Station 
Data Management 


4 Find a Library 


Librarian Find 
X.21 SHM Line 


Configuration 
Load Module 
Builder 
(SXNSH) 


Library Member 
Protect 


Library Sector 
Put/Get 


Printer Data 
Management 


SYSLOG 
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Chart 9.4.4 DEFINX21 SHM Line Configuration Control Flow 
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AUTOCALL SUPPORT SUBFUNCTION 


The autocall feature is an attachment to MLCA/ELCA 
that allows the user to place calls on a switched line 
without operator intervention. The numbers to be called 
are contained in a phone list built by the DEFINEPN 
procedure. In addition to placing the calls, autocall 
monitors and updates the status of calls in the phone 
list. 


The following autocall processes are shown in Chart 9.5: 

1 Process IOB call request, using |OB-provided phone 
list pointer, task ID, device code and 
communications line number. 


2 Display results of call (successful or unsuccessful). 


3 Post the caller successful or unsuccessful. 


4 Process reset request by resetting status of call and 
posting request to caller. 


Control Storage 
Requests fom ~|— | oo0o fo 4 | ,aa---------- 


Protocol Link 
Controls: 


Ge es eee i oo os w= c= 


Autocall Task 
(#GCAC) 


MSRJE BSC 
SSP-ICF BSC 
Batch BSC 
SDLC 
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Chart 9.5 Autocall Support Control Flow 
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REMOTE WORK STATION (RWS) SUPPORT 
SUBFUNCTION 


System/36 remote work station (RWS) support makes 
work stations attached to the System/36 via 
SNA/SDLC or X.25 appear the same as locally attached 
work stations. It allows the user to access remote work 
stations without having any knowledge of data 
communications protocols. (For information on RWS 
protocols, refer to Appendix A: Data Communications 
Line Protocols.) 


The RWS support contains its own SNA support and 
Operates as an independent task. The RWS mainline 
task ensures that proper SNA protocols are followed. 
Initialization, termination, and error recovery execute as 
overlays; they receive control via transfer supervisor call 
instructions. The overlays have addressability to system 
areas and the first 4K bytes (RWS work area and 
common subroutines) of the mainline task. 


Note: The term data link control (DLC) is used 
throughout this description of the remote work station 
subfunction to mean either the SDLC or the X.25 data 
link control. Remote work station support accesses both 
data link controls via the SNA-to-data-link-control 
interface (#SDRI). 
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The following RWS overview processes are shown in 
Chart 9.6.0: 


1 Process RWS Vary-On and Vary-Off commands 
from system console. 


2 Process requests for work at a remote station. 
3 Attach or detach SNA/SDLC task. 
4 Process DLC IOBs. 


5 Attach 3270 remote attach tasks for each 3274 
controller. 


6 Translate between 3270 and 5250 data stream. 
Detach 3270 remote attach tasks for each 3274 
controller. 
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RWS Exception 
Processing 
(Chart 9.6.4) 
RWS 
Initialization / 
Termination 
(HRWVO, #RWVF, SDLC Task 
#RWDL) (Chart 9.2.0) 


Control Storage 


3270 Remote 
Attach Mainline 
Task (HRAML) 


$0590329-2 


Chart 9.6.0 Remote Work Station (RWS) Support Overview Control Flow 
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RWS consists of four basic parts: 


e RWS vary on Chart 9.6.1.n 
- RWS put/get data Chart 9.6.2.n 
e RWS vary off Chart 9.6.3 
e RWS exception processing Chart 9.6.4 


Remote Work Station (RWS) Vary On 


RWS support can be activated by IPL (if any remote 
work stations are configured for auto-vary online), or by 
the system operator via the Vary-On command. The 
following table summarizes the sequence of events that 
occur during vary on. The columns list the request type, 
the module (and, in some cases, the routine) that builds 
and/or posts the request and its associated control 
blocks, the module that initially processes the request, 
and the module to which a successful return code is 
routed. 


Vary On for 5250 Devices 


ee Initially Successful Return Code 
Sequence |Request Processed By | Routed To 


an a a en 
| 3 OPEN station _#RWVO | #SDRI_—ARWVO via #RWAS 
ft a on a omens | 
| 5 _|snrm___#rwvo #SDRI_#RWVO via #RWAS 
| 6 lactiu ss #RWAS —#SDRI#RWAS 


VARY ON SUCCESSFUL message is issued at this point. 


| 7 pInn#rwas #0 #RWAS 


lf BIND indicates the station is a 5294 controller, the controller is loaded downline in the 
= two sequences: 


LOAD QUERY #RWDL #SDRI #RWODL via #RWAS 
COMMAND 


LOAD #RWDL #SDRI #RWDL via #RWAS 
REQUEST 
REPLY 


When controller is completely loaded, #RWAS sends power-on aid to command processor 
for display stations attached to the controller and, if printer spooling is active, attaches 
spool writer for printers attached to controller. 
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Vary On for 3270 Devices 


Built/Posted | Initially Successful Return Code 
Sequence |Request By Processed By | Routed To 


| 1 OPEN Ine | #RWVO_#SDIT #RWVO 
ENABLE line #RWVO #SDIT #RWVO via #RWAS 
Pg OPEN station #RWVO ¥SDRI #RWVO via #RWAS 


XID (for switched | #RWVO #RWVO via #RWAS 
lines only) 


| 5 sym l#nwvo | #soRI | #RWWVO via #RWAS 


gg ACTPU #RWAS ¥SDRI #RWVO via #RWAS 


When ACTPU completes, #RMVO attaches the 3270 remote attach task for the controller. 


| 7 actu _i#nwasl#son; RAS 
VARY ON SUCCESSFUL message is issued at this point. 

| 8 BND #RWAS SOR, #RWAS 
| 9 jsor_iwnwas isons i#nwas 
| 10 jem #nwas sons RAS 


When the BID completes, #RWAS sends power-on aid to command processor for display 
stations or, if print spooling is active, attaches spool writer for printers (for non-IPDS devices). 


(IPDS only) 


41 _|iniT4Pps #RWAS | #SDRI_— #RWAS 


When INIT-IPDS completes and if print spooling is active, #RWAS attaches the spool writer 
for the printer. 
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The following vary-on processes for 5250 devices are 
shown in Chart 9.6.1.1: 


If this is the first vary on, build all remote line 
information blocks (RWLBs), remote work station 
alternate line blocks (RWALTs) for switched lines, 
and controller unit blocks (CUBs). 


Build and initialize device unit block (DUB) and DUB 
extension for device, and post RWS task for vary 


on. 


Route RWLB, CUB, and/or DUB to vary-on 


If BIND indicates the controller is capable of being 
downloaded, do the following: 


e Send load query command to controller via 
#RWAS and data link control. 


e Process load request command from controller. 
Pass load query reply from controller to #RWDL. (If 
the load query reply indicates there are more 


requests, repeat the above download sequence. 


Process transmit IOBs. 


processor, depending on vary-on command. 
8 Complete vary on by doing the following: 

3 Perform any required DLC/controller initialization: 

e If bind is for a display station, post the 
command processor with a power-on aid, 
which allows the command processor to send 
the sign-on screen. 


e — If line is not open, call DLC initialization/ 
termination to open it. 


e — If control unit is not initialized, do the following: 
— Build an IOB with an open station ¢ If bind is for a printer and spooling is being 
command; post the IOB to DLC. used, attach the spool writer. 
— After open station IOB returned, build an 
lIOB with an XID command and post it to 
DLC. 
— After lIOB with an XID response is returned, 
build an IOB with an SNRM command and 
post it to DLC. 
— Return IOB with SNRM command to 
#RWAS. 


4 Perform SNA session initialization: 


e Build IOB with ACTLU command and post it to 
DLC. 


e lf ACTLU response indicates that device is 
powered on, build an IOB with a BIND 
command, and post it to DLC. 
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The following vary-on processes for 3270 devices are 
shown in Chart 9.6.1.2: 


If this is the first vary on, build all remote line 
information blocks (RWLBs), remote work station 
alternate line blocks (RWALTs) for switched lines, 
and controller unit blocks (CUBs). Build and initialize 
device unit block (DUB) and DUB extension for 
device and post RWS task for vary on. 


Route RWLB, CUB, and/or DUB to vary-on 
processor, depending on vary-on command. 


Perform any required DLC/controller initialization: 


e If line is not open, call DLC initialization/ 
termination to open it. 


e If control unit is not initialized, perform the 
following: 

— Build an IOB with an open station command 
and post the IOB to DLC. 

— After open station IOB returned if the 
controller is configured on switched lines, 
build an IOB with an XID command and 
post it to DLC. 

— After XID IOB response received, or if 
controller is configured on leased lines, 
build an JOB with an SNRM command and 
post it to DLC. 

— After SNRM IOB returned, build an ACTPU 
command and post it to DLC. 

— Wait for positive response from ACTPU. 


4 When positive response to ACTPU is received, 


attach the 3270 remote attach mainline task. 
Return to #RWAS. 


Perform SNA session initialization: 


e Build IOB with ACTLU command and post it to 
DLC. 


e If ACTLU response indicates device is available, 
build an 1OB with a BIND command and post it 
to DLC. 


e After a BIND response is received, build an lIOB 
with an SDT command and post it to DLC. 


e After SDT response is received, build an |OB 
with a BID command and post it to DLC. 


e After BID response is received if device is an 
IPDS printer, build an IOB with an INIT-IPDS 
command and post it to DLC. 


After BID response or INIT-IPDS response (for an 
IPDS printer) is received, perform the following: 


e If the response is for a display station, post the 
command processor with a power-on aid, 
which allows the command processor to send a 
sign-on screen. 


¢ If response is for a printer and spooling is being 
used, attach the spool writer. 


Process transmit IOBs. 


Process receive IOBs. 
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Remote Work Station (RWS) Get Data/Save Screen 3 Process IOB and 256 bytes (maximum) of get/save 


for 5250 Display Stations data from DLC: 
RWS get data/save screen in initiated by a post from ¢ Fora get, assign WSQS for received data. For 
work station data management with a TUB marked with a save, use TWS assigned by work station data 
a get data or save screen request. On a save screen management for received data. 
request, the TUB process bytes (attribute bytes 
indicating current status of display) are also saved as e If more than 256 bytes of get or save data, 
part of the data. continue to process IOBs posted by DLC. 
The following get data/save screen processes for 5250 4 If not enough available WSQS, write data to TWA 
display stations are shown in Chart 9.6.2.1: on disk. 
1. Do the following: 5 If invalid data amount, handle the exception. 

e Build an IOB containing a read command. 6 Post work station data management with updated 


TUB after all get/save data has been received. 
e Set up SNA transmission header (TH) and 
request header (RH) for transmit. 


2 Post DLC with DLC transmit |OB containing read 
command. 


Work Station 
Data Management 


SNA-to-DLC 

Interface 

(Chart 9.2.3) Read/Write 
4 Data to Disk 


Mainline 
Task 
(#RWAS) 


(#RWDD) 


Negative Response 
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Chart 9.6.2.1 Remote Work Station Get Data/Save Screen Control Flow for 5250 Display Stations 
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Remote Work Station (RWS) Get Data/Save Screen 4 Post 3270 remote attach mainline to translate data 


for 3270 Display Stations or command. 

RWS get data/save screen is initiated by a post from 5 Perform one of the following: 

work station data management with a TUB marked with 

a get data or a save screen request. On a save screen e — If the command is read screen or read input 
request, the TUB process bytes (attribute bytes fields, assign WSQOS and move the latest 
indicating current status of display) are also saved as screen data (saved in an internal buffer called 
part of the data. the shadow buffer) to the WSOS. 

The following get data/save screen processes for 3270 e — |f the command is save screen, use TWS 
display stations are shown in Chart 9.6.2.2: assigned by work station data management for 


received data. 
1 Perform the following: 
e For other get data commands, translate the 


e If request is a get data read input fields or a get 3270 data to 5250 data, assign WSQS, and 
data read screen, go to process 4. move the translated data to the WSOS. 
e Build an IOB containing a read command. 6 Post work station data management with updated 
TUB after all get/save data has been received. If 
e Set up SNA transmission header (TH) and invalid data amount, handle the exception. 


request header (RH) for transmit. 


2 Post DLC with DLC transmit IOB containing read 
command. 


3 Process IOB and 256 bytes (maximum) of get/save 
data from DLC: 


e Move data from IOB to TWS assigned by 3270 
remote attach. 


e If more than 256 bytes of data, continue to 
process IOBs posted by DLC. 
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Interface 
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Chart 9.6.2.2 Remote Work Station Get Data/Save Screen Control Flow for 3270 Display Stations 


Section 2: Data Communications Function E 2-459 
This document contains restricted materials of IBM. LY21-0590-4 


©Copyright IBM Corp. 1983, 1984, 1985, 1986 


This page is intentionally left blank. 


2-460 
This document contains restricted materials of IBM. LY21-0590-4 
©Copyright IBM Corp. 1983, 1984, 1985, 1986 


Remote Work Station (RWS) Put Data/Restore 2 Post DLC with DLC transmit IOB(s) containing write 


Screen for 5250 Display Stations command and data. 

RWS put data/restore screen is initiated by a post from 3 Wait for response from remote controller and verify 
work station data management with a TUB marked with response. 

a put data or restore screen request. On a restore 

screen request, the TUB process bytes (attribute bytes 4 If a positive response is received, post work station 
indicating saved status of display) are restored from part data management. 

of the data. 


5 If a negative response is received, call the negative 
The following put data/restore screen processes for response handler. 
5250 display stations are shown in Chart 9.6.2.2: 


1 Do the following: 


e Build an SDLC IOB with a maximum of 256 
bytes of put data. 


e Set up SNA transmission header (TH) and 
request header (RH) for a transmit IOB. 


e If more than 256 bytes of data, continue 
building IOBs. 


¢ If restore request: 

- Assign WSQS. 

— If data is stored on disk, read data from 
disk and move the data from the TWA on 
disk to the WSQS buffer. 

— Build DLC IOB. 


Work Station 
Data Management 


SNA-to-DLC 
Interface 
(Chart 9.2.3) 


RWS 
Mainline 
Task 
(#RWAS) 


Negative Response 
Handler 
(Chart 9.6.4) 
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Chart 9.6.2.3 Remote Work Station Put Data/Restore Control Flow for 5250 Display Stations 
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Remote Work Station (RWS) Put Data/Restore 
Screen for 3270 Display Stations 


RWS put data/restore screen is initiated by a post from 
work station data management with a TUB marked with 
a put data or restore screen request. On a restore 
screen request, the TUB process bytes (attribute bytes 
indicating saved status of the display) are restored from 
part of the data. 


The following put data/restore screen processes for 
3270 display stations are shown in Chart 9.6.2.4: 


1 


Post RWS with a TUB marked put data or restore 
screen. 


2 Post the 3270 remote attach mainline task with the 

TUB. 

3 Call the 5250 to 3270 data stream translation 
routine, which does the following: 

e lf restore request, move saved data from disk 
to the pre-assigned TWS. 

e Otherwise, translate the data to 3270 data 
stream and put the translated data in the 
pre-assigned TWS. 

e Update the internal screen buffer (shadow 
buffer) to have the latest data on the display 
station's screen. 
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Post RWS to do the following: 


e Build an SDLC IOB with a maximum of 256 
bytes of put data. 


e Set up SNA transmission header (TH) and 
request header (RH) for a transmit IOB. 


e If more than 256 bytes of data, continue 
building IOBs. 


Post DLC with DLC transmit IOB(s) containing write 
cOmmand and data. 


Wait for response from controller. 


If a positive response is received, post work station 
data management. 


If a negative response is received, call the 3270 
remote attach exception translator (FRWNA). 


Call one of the RWS exception handlers (#RWNR, 
#RWER). 
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Chart 9.6.2.4 Remote Work Station Put Data/Restore Control Flow for 3270 Display Stations 
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Remote Work Station (RWS) Printer Put/Get 


RWS printer operations are initiated by a posted printer 
unit block (PUB) from command processor error 
recovery or by a posted printer IOB from other tasks. 


The following printer put/get operation processes are 
shown in Chart 9.6.2.5: 


1. Process the PUB or printer IOB post by finding the 
first printer IOB queued for the associated printer. If 
the printer is an IPDS printer or a 5250 SCS printer, 
go to process 5. 


2 Move the printer IOB data to pre-assigned TWS for 
translation and post the 3270 remote attach task 
with the associated PUB. 


3 Translate the data from 5250 SCS data to 3270 
SCS data. 


4 Post the RWS mainline back with the PUB. 
5 Process the printer operation: 


e If the printer is IPDS, build a DLC IOB and send 
the put or get command with the appropriate 
5250 or 3270 transmission header (TH) and 
request header (RH). 


e If the printer is a 5250 SCS printer, build a DLC 
1IOB and send the put data with transmission 
header (TH) and request header (RH). 


e If the printer is a 3270 SCS printer, build as 
many DLC IOBs as necessary to handle all of 
the translated data in TWS, and set up the 
transmission headers (TH) and request headers 
(RH). 
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Process the receive DLC IOB: 


e — If the DLC IOB contains printer status for an 
IPDS printer, move the data into the associated 
printer IOB storage and go to process 9. 


« — If the DLC IOB contains a positive response to a 
non-spooled put, go to process Y. 


« — |f the DLC IOB contains a positive response to a 
spooled put, find the related “dummy” IOB and 
go to process Q. 


If the DLC IOB contains a 3270 exception (negative 
response, LUSTAT, or signal), call #RWNA to 


translate it to the appropriate 5250 exception. 


Call one of the RWS exception handlers to process 
the exception. 


Post the printer |OB complete. 
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3270 Remote Attach 5250 SCS to 3270 SCS 
Mainline Task Data Stream Translation 
(#ARAML) Routine (fRAPRT) 


Command 
Processor 


SNA-to-DLC 
Interface 


RWS Mainline (Chart 9.2.3) 


Task 
(#RWAS) 


Printer Data 
Management or 
Spool Writer 

or IPF 


3270 Remote Attach 
Exception Translator 
(ARWNA) 


RWS Exception Handlers 
(ARWNR, #RWER) 


(Chart 9.6.4) 


$0590496-1 


Chart 9.6.2.5 Remote Work Station Printer Put/Get Control Flow 
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Remote Work Station (RWS) Vary Off 


The system operator deactivates RWS support with the 
Vary-Off command. The following table summarizes the 
sequence of events that occur during vary off. The 
columns list the 1|OB operation code or command, the 
module that builds and/or posts the IOB and its 
associated control blocks, the module that initially 
processes the request, and the module to which a 
successful return code is routed. 


Vary Off for 5250 Devices 


IOB Operation 
Code or Built and Initially Successful Return 
Sequence (Command Posted By Processed By |Code Routed To 


Lk | UNBIND #RWVF ¥SDRI #RWVF via #RWAS 
pn DACTLU #RWVF ¥SDRI #RWVF via #RWAS 


VARY OFF SUCCESSFUL message is issued at this point. 


REQMS (Sent) |#RWAS #RWAS 
and RECFMS 
(Received) 


DISCONNECT | #RWVF DLC mainline #RWVF via #RWAS 
| TERMINATE #RWVF DLC mainline #RWVF via #RWAS 


Vary Off for 3270 Devices 


IOB Operation 
Code or Built and Initially Successful Return 
Sequence |Command Posted By Processed By (Code Routed To 


UNBIND #RWVF #spr|_| #RWVF via #RWAS 
DACTLU #RWVF ¥SDRI #RWVF via #RWAS 


VARY OFF SUCCESSFUL message is issued at this point. 


| 3 [pacteu_ivrwas esprit #nwas 


3270 remote attach task is detached at this point. 


Ce DISCONNECT |#RWVF DLC mainline | #RWVF via #RWAS 
| | TERMINATE  |#RWVF DLC mainline |#RWVF via #RWAS 
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The following vary-off processes are shown in Chart 
9.6.3: 


1 ‘If vary-off command, process by posting RWS task 
with DUB or RWALT to be varied off. 


2 Route DUB or RWALT to vary-off processor 
(#RWVF). 


3 Perform necessary SNA session termination: 


e Build lIOB containing an UNBIND command and 
post it to DLC. 


e Build IOB containing a DACTLU command and 
post it to DLC. 


e If last DUB on control unit, send REQMS to get 
maintenance statistics, or send DACTPU if 
control unit is a 3274. 


e If there are no possible lines, free the DUB. 


RWS Vary 
Initialization 
(ARWVY) 


2 


Command 
Processor 


RWS Mainline 


(#RWAS) 


Chart 9.6.3 Remote Work Station Vary-Off Control Flow 
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e Perform necessary DLC station termination by 
building DISCONNECT IOB and posting it to 
DLC. 


e Perform necessary DLC line termination by 
building TERMINATE IOB and posting it to DLC. 


e When no remote DUBs are left on any line, 
issue EOJ for RWS. 


Route complete IOBs, positive responses from 
controller, and received RECFMS commands from 
data link control 


Route UNBIND and DACTLU IOB responses to 
#RWVF. 


Detach 3270 remote attach task when response to 
DACTPU is received. 


3270 Remote Attach 


Mainline Task 
(#RAML) 


Vary-Off 
Processor 
(#RWVF) 


SNA-to-DLC 
Interface 
(Chart 9.2.2) 


$05380335-2 
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Remote Work Station (RWS) Exception Processing 


Remote work station (RWS) exception processing 
receives its input from the DLC task. In addition to 
handling DLC link errors and device errors, it also 
processes commands to/from the System/36 SNA data 
flow control (DCF) command handler. 


The RWS negative response handler, the RWS DFC 
command handler, and the link error handler, all set up 
dump requests if their processing indicates there might 
be a problem in IBM-supplied programming; they also 
call the control storage printer/display error router 
(SNUPD) to route the error to the proper component. 
Other processes performed by RWS exception 
processing, shown in Chart 9.6.4, are: 


1 Route for the following: 
e Error IOBs. 
e Received IOBs containing SNA error status. 


¢ 1OBs containing SNA data flow control (DFC) 
commands. 


If link error, route to link error handler. 
lf a LUSTAT from a remote controller requests the 
downloading of a GAIJI character matrix to a 5555 
display station, post RWS DFC command handler. 
2 If negative response IOB, pass the IOB and control 
to #RWNER. If link error, route to #RWLK; 
otherwise, pass IOB and control to #RWER. 
3 Process the negative response: 
¢« If error recovery for this device is already in 
progress, ignore the error and return to 
mainline. 


« Set DUB sense bytes to indicate error type. 


e If device is varying on or off, indicate that vary 
failed. 


e If negative response was for a command reject, 
set up to send change direction indicator. 


e Return to mainline. 
4  \|f acommand reject was processed, build an IOB 


for change direction indicator and pass it to the DLC 
task. 
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10 


Process the data flow control (DFC) commands 
(signals, LUSTATs, RSHUTD): 


e If this device is already busy, pend the request 
and return to mainline. 


e Set DUB sense bytes to indicate error type. 


¢ If command was shutdown request (RSHUTD) 
indicate that UNBIND should be sent to device. 


° Return to mainline. 


Build a response to the DFC command and pass it 
to the DLC task. 


If DFC command is in response to a request for the 
downloading of a GAIJI character matrix, mark TUB 
with appropriate AID and post the command 
processor. 


Process GAIJI AID request by posting the GAIJI 
task for character matrix download. 


Find requested character matrix, and send it to the 
5555 Display Station by posting a TUB (with PUT 
request) to the RWS task. 


Process put of GAIGI character string to 5555 
Display Station. 


Process link error IOB: 


¢« If open station IOB has failed, build an RWS 
message block and post It. 


e Perform the following for each device in error: 

— Get DUB for device. 

— If error processing is already in effect for 
this device, pend this error. 

— Set DUB sense bytes to indicate error type. 

— If device vary-on failure, indicate it. 

— If auto-reconnect is configured, indicate 
that device is to be reconnnected and do 
the following: 

— lf line error or switched line, send 
terminate /reenable. 
— If station error, build disconnect. 

— Return to mainiine. 
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11 Process RWS message block, and any other 14 Issue OPEN STATION, issue message indicating 


processing required by #RWLK. Route terminate vary on in progress, and continue with normal 
and disconnect responses to #RWVF. vary-on sequence (Chart 9.6.1). 

12 If terminate or disconnect request was received for 15 Post data link control with transmit IOB containing 
auto-reconnect line(s), reset all error indicators in terminate and disconnect commands. 
controller unit blocks (CUBs) and device unit blocks 
(DUBs) being reconnected, and post each CUB to 16 Post data link control with transmit |OBs containing 
#RWAS. SNA responses. 


13 Route CUBs from #RWVE to #RWVO for 
completion of reconnect sequence. 


RWS Negative 
Response Handler 
(#RWNR) 


RWS 
Mainline 
(HRWAS) 


DLC 
Interface 
(Chart 9.2.3) 


Vary-Off Processor 
(#RWVF) 


Link Error 


Handler 
(ARWLK) 


Chart 9.6.4 Remote Work Station Exception Processing Control Flow 


RWS Data Flow 
Control (DFC) 
Command Handler 
(#RWER) 


GAIJI Task 
(#GAML) 


Vary-On Processor 


(#RWVO) 


$0590336-1 


Section 2: Data Communications Function 9 | 2-471 


This document contains restricted materials of IBM. LY21-0590-4 
©Copyright IBM Corp. 1983, 1984, 1985, 1986 


LINK STATION TEST 3 Perform error recovery: 


The link station test subsystem allows a user to send a « Process test error completion codes from SDLC. 
test command to a secondary SDLC station address. 

The test verifies the link between the system and the ¢« Process abnormal response from station. 
terminal or other system. Link station test can be 

executed while other primary SNA subsystems are e Process SDLC failure. 

executing, but cannot be run to a station being used by 

another SNA/SDLC function. The link station test is « lf the user selects SYSLOG option 3, pass 
invoked by the STATEST command. control to abnormally terminate. 

The following link station test processes are shown in 4 Display any required error messages. 

Chart 9.7: 


5 Perform the following termination processing: 
1 Perform the following initialization processing: 


e Close the line. 
e Initialize data areas. 


« Route control to SDLC termination to detach 
« Route control to SDLC initialization to open SDLC. 


communications line. 


« Call SSP termination to terminate link station 
« Route control to open and allocate work station test. 


DTF. 


e Use work station data management to prompt 
for and process user responses. 


« If necessary, route control to abnormally 
terminate. 


2 Perform the following test processing: 
e Build 1OB and transmit test command to each 
operational station on the station list, using 
SNA-to-SDLC interface. 


« Process responses. 


« Use work station data management to display 
test status to user. 


« Route for error recovery when necessary. 


« Route for abnormal termination on user request 
or timer expiration. 
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Chart 9.7 Link Station Test Control Flow 
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X.25 SUPPORT SUBFUNCTION 


IBM-supplied X.25 programming for System/36 
consists of packet switching interface support for the 
SSP. The System/36 Packet Switching Interface 
support in conjunction with the System/36 X.25 feature 
enables an application program running under the 
System/36 SSP to communicate with remote locations 
through an X.25 packet switching network. 


System/36 X.25 support performs the following tasks: 
e Manage X.25 communications protocols. 


« Provide interface to a host system using the SNA 
Upline Facility (SNUF), SNA 3270 support, SNA 
MSRJE, or APPC. 


¢ Provide interface to remote 3600 and 4700 
controllers using the SNA Finance subsystem. 


¢« Provide interface to remote 5251 Model 12 Display 
Stations using remote work station support (RWS). 


¢« Provide interface to a System/34 or another 
System/36 using SNA Peer support. 


¢ Provide interface to a remote station using the 
station test subsystem. 


* Provide interface to a remote asynchronous work 
Station using the asynchronous subsystem. 


¢ Provide support for up to 16 active X.25 logical 
channels on each of up to three X.25 lines. 


e Provide utility programs to define the X.25 network 
interface characteristics; to temporarily alter some of 
the X.25 network interface characteristics; to 
monitor the status of the X.25 links; to create 
network address lists; and to accumulate, display, 
reset, and print tariff-related statistics. 


e Provide the capability to automatically connect and 
disconnect X.25 virtual circuits when a remote 
station is varied on/enabled and varied 
off /disabled. 


¢ Support the association of stations on a switched 
line to switched virtual circuits, and the association 
of stations on a nonswitched line to switched or 


permanent virtual circuits. 


¢« Provide for error recovery. 
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System/36 X.25 support runs under the System/36 
SSP; it requires a system unit with a minimum of 256K 
bytes of main storage. The X.25 mainline task requires 
32K bytes of nonswappable main storage, and the 
initialization/termination task requires 22K bytes of 
swappable main storage. The X.25 maintenance utility, 
the X.25 configuration utility, and the X.25 phone list 
utility each require 24K bytes of swappable main storage 
when they are loaded. 


All X.25 main storage to control storage 
communications is done between X.25 main storage 
programs and the X.25 control storage programs for the 
particular line, via the control storage MLCA/ELCA and 
MLCA/ELCA IOCH processors. 


The System/36 X.25 support programs execute as 
independent tasks. Application programs use them via 
SSP-ICF and remote work station (RWS) support to 
establish, maintain, and terminate communications 
sessions with remote stations. X.25 support consists of 
the following programs: 


e  Initialization/termination task 
e Mainline task 
e Abnormal termination tasks 


e Utilities for X.25 configuration, maintenance, and 
phone list definition 
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Initiator 


X.25 Utilities 
Application Programs (Charts 9.8.4.1 to 
9.8.4.3) 


Applicable 
SNA Task 


X.25 Support 


@ Initialization/ Termination Task 
(Chart 9.8.1) 

@ Mainline Task 
(Chart 9.8.2) 
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Cont Storage 
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Chart 9.8.0 X.25 Overview Control Flow 
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X.25 Initialization/Termination Task 

The X.25 initialization/termination task performs all 
operations necessary to initiate and terminate the X.25 
links. It uses the configuration data to establish the links 
to the network. 

The X.25 initialization/termination task posts IOBs to the 
control storage MLCA/ELCA IOCH processor for enable, 


disable, and open link operations. 


The following X.25 initialization/termination task 
processes are shown in Chart 9.8.1: 


1 Initialize and terminate X.25 tasks: 


e Enable X.25 link (load SNA to DLC interface, 
#SDRI). 


¢ Open/terminate communications line for X.25 
communications. 


¢ Enable/disable adapter. 
2 Do the following: 

e Issue console messages. 

e Log error counter table. 

e Log X.25 tariff information. 

e Log IOBs and data in system trace area. 

e Determine tf normal or abnormal termination. 
3 Perform normal termination of the X.25 tasks. 


4 Perform abnormal termination on X.25 mainline or 
MLCA/ELCA processor check. 


5 Process IOBs for enable, disable, and open link 
operations. 


Note: MLCA/ELCA IOCH routes requests to the 
MLCA/ELCA processor. The MLCA/ELCA supervisor 
then passes the requests to the control storage X.25 
code for the specified line. 
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Chart 9.8.1 X.25 Initialization/Termination Task Control Flow 
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X.25 Mainline Task 3 Perform the following initialization interface 


functions: 
The mainline task performs the control operations 
necessary for X.25 support. It routes control - Put task attached by #XTIT in wait state. 
information to and from the X.25 feature. It also routes 
data between the X.25 feature and remote work station 
support or an SSP-ICF subsystem. The mainline task 


Enable VCB group. 


establishes and terminates virtual circuits. ¢« Add VCB group. 
The following X.25 mainline task processes are shown ¢ Process message response. 
in Chart 9.8.2: 


4 Provide interface for X.25 microcode requests: 
1 Process IOBs from the applicable SNA task for X.25 


functions. e Process completion of requests to microcode. 
2 Route requests to the X.25 microcode: for the ¢« Process hardware or software error by 

following, based on the SNA or RWS operation transferring to #XTEH for error history table 
codes: logging and error recovery. 
¢ Open virtual circuit on incoming call: 5 Log IOBs and data in system trace data area. 

— Validate incoming call packet's facility field. 

-— Validate incoming call packet's call user Note: Opening and closing virtual circuits, and enabling 

data. and terminating VCB groups is done by transferring to 
— Build an OPEN SVC IN IOB and send it to #XTOC. 


X.25 microcode. 


e Open virtual circuit for outgoing call: 
— Call specified VCB location. 
— Allocate a free logical channel for call. 
— Build an OPEN SVC OUT or OPEN PVC 
lIOB, and send it to X.25 microcode. 


e Build call user data for a SVC OUT IOB. 


e Build facility field for an SVC IN or SVC OUT 
lOB. 


e Close virtual circuit. 


¢  Transmit/receive. 
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Chart 9.8.2 X.25 Mainline Task Control Flow 
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X.25 Abnormal Termination Task 
The abnormal termination task consists of two 
transients that handle abnormal termination of the X.25 


mainline task or the MLCA/ELCA. 


The following X.25 abnormal termination task processes 
are shown in Chart 9.8.3: 


1 Do the following: 


« Notify #XTAT of processor check in #XTML or 
MLCA microcode processor check. 


« Post #XTAT to acknowledge receipt of control 
for #XTIT processor check abnormal termination 
processing. 

e Process all |OBs normally posted to #XTML; 
post terminate/detach IOBs (from SNA) to 
HXTAT. 

2 Do the following: 


« Acknowledge post notifying of #XTML or MLCA 
microcode error. 


¢ Process SNA terminate/detach IOB. 


3 Begin error processing when posted out of wait for 
#XTIT error processing. 


4 Do the following mainline functions: 
5 Disable the communications adapter. 


6 Clear the lines by waiting for and processing 
terminate/detach or line open detach. 


7 Clear the line queues and requeue internal IOBs 
onto network control blocks (NCB). 


8 Clear the transmit queues of all virtual circuit blocks 
(VCBs) on the X.25 links. 


9 Post internal IOBs to SNA to notify SNA of error. 


10 Deallocate lines and log job counters. 
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Chart 9.8.3 X.25 Abnormal Termination Control Flow 
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X.25 Utilities 


X.25 Configuration Utility 


The X.25 configuration utility allows a user to define the 
network configuration, the logical channel configurations, 
and the virtual circuit configurations. 


The X.25 configuration utility is invoked by the 
CNFIGX25 procedure or equivalent OCL and utility 
control statements. If necessary, the CNFIGX25 
procedure builds the #X25LIB library using $MAINT. 


The following X.25 configuration utility processes are 
shown in Chart 9.8.4.1: 


1 Perform mainline routing for utility. 

2 Prompt operator for configuration option: 
¢ Get option entered by user from main menu. 
e Display errors or return valid data. 

3 Route to network and logical channel configuration 
overlays: 
e Display network configuration option menu, 

errors, and valid data. 

4  Edit/update a network configuration. 

5 Delete a network configuration. 

6 Print a network configuration. 

7 Route to virtual circuit configuration overlays. 

8 Display library/member selection screen, errors, 
and valid data. 

9 Edit and update a virtual circuit configuration. 

10 Delete a virtual circuit configuration. 

11 Format and print a virtual circuit configuration. 
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Chart 9.8.4.1 X.25 Configuration Utility Control Flow 
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X.25 Maintenance Utility 4 Display and control active virtual circuit 


configuration selection: 
The X.25 maintenance utility allows the user to display 


Status information about the X.25 links, and to 
temporarily alter some of the virtual circuit configuration 
parameters. 


e Display list of active virtual circuit members. 


e« If requested, display status of virtual circuits in 


an active virtual circuit member. 
The maintenance utility is invoked by the MAINTX25 


system procedure or equivalent OCL and utility control 
statements. 


¢« If requested, update 
active-virtual-circuit-member-list display 


screen. 
The following X.25 maintenance utility processes are 


shown in Chart 9.8.4.2: ¢ If requested, edit virtual circuit parameters of a 


station in an active virtual circuit member. 
1 Display X.25 maintenance utility menu and perform 


mainline routing for operator responses. 5 If requested, process call wait queue status/edit 


option: 
2 Control configuration member with tariff totals 


selection: ¢ Display list of stations on the call-wait queue. 
e Display list of virtual circuit members with tariff 


e If requested, update stations on the call-wait 
totals. 


queue display screen. 


e |f requested, display virtual circuit tariff totals 


e If requested, edit virtual circuit parameters of a 
for a virtual circuit member. 


station on the call-wait queue. 


« If requested, print (and reset) virtual circuit tariff 
totals for a virtual circuit member. 


3 Get and display logical channel status; if requested, 
update logical channel status display screen. 
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Chart 9.8.4.2 X.25 Maintenance Utility Control Flow 
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X.25 Phone List Utility 

The X.25 phone list utility creates a new X.25 phone list 
load member, or alters, removes, or prints an existing 
X.25 phone list load member. The X.25 phone list utility 
is invoked by the DEFINX25 system procedure or 
equivalent OCL. 


The following X.25 phone list utility processes are 
shown in Chart 9.8.4.3: 


1 Do the following: 
e Perform the operation requested. 
« Route for the following: 
2 Syntax check utility control statements. 


3 Issue read/write requests for phone list load 
members. 


4 Issue any required messages. 


5 Terminate this job step. 


Initiator 


El 


Syntax Checker 


Control Storage 


X.25 

Phone List 

Utility 

(SXTAL) 4 SYSLOG 


5 Termination 
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Chart 9.8.4.3 X.25 Phone List Utility Control Flow 
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DISPLAY STATION PASS-THROUGH SUPPORT 


The Display Station Pass-Through support allows a user 
working at a display station attached to a System/36 or 
System/38 to sign on to a remote System/36 or 
System/38 and run applications on the remote system. 
There are two tasks associated with each display station 
pass-through session. The System/36 source task is an 
SRT and runs on the System/36 that the display station 
is locally attached to. The System/36 target task is an 
MRT and runs on the remote System/36. 


Source Display Station Pass-Through Support 


The System/36 Source Display Station Pass-Through 
Support consists of initialization of the display station 
pass-through session on the source system and the 
operation request processing. 


The operation request processing consists of accepting 

and decoding requests from the target task and issuing 

the appropriate WSDM operation. Upon completion of 

WSDM, a reply is sent to the target task with input data 
if there is any. 


2-488 


The following source display station pass-through 
overview processes are shown in Chart 9.9.1: 


1 


Receive control from the initiator and perform the 
initial setup. 


Evoke the target display station pass-through 
program. 


Receive operation requests from the target display 
Station pass-through subfunction. 


Decode the operation request and issue the 
appropriate operation to WSDM. 


For message light requests, issue the request to 
WSIOCH if it is a local display station. 


For message light requests, issue the request to 
RWS if it is a remote display station. 


Send operation reply to the target display station 
pass-through subfunction upon completion of the 
operation. 


For error messages, use SYSLOG. 


When end-of-transaction is received, go to end of 
job. 


10 Perform source cleanup for source termination. 
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Chart 9.9.1 Source Display Station Pass-Through Support Control Flow 
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Target Display Station Pass-Through Support 


The System/36 Target Display Station Pass-Through 
support allows display station requests from applications 
to be directed to displays attached to remote systems. 


The Target Display Station Pass-Through support runs 
as a MRT that is loaded by the display station 
pass-through target procedure (X’7B30FOFOFS’). 


This task builds the necessary display station 
pass-through resources needed on the target system 
(vary on of a display station pass-through TUB) and 
accepts operation requests directed to the display station 
pass-through TUBs. 


1 Receive control from the initiator and perform initial 
setup. 


2 Accept any new requesters as they are attached to 
the target MRT. 


3 For new requesters, vary on a display station 
pass-through TUB. 


4 Accept posts from WSDM to do work on a display 
Station pass-through TUB. 
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10 


11 


12 


13 


Send an operation request to the source display 
station pass-through subfunction. 


Receive reply from source display station 
pass-through for operation completion and process 
operation completion. 


Handle command processor operation requests such 
as message light requests. 


For System/38 attached display station errors, map 
the negative response data to the TUB sense bytes 
and call $NUPD so user program gets a permanent 

error return code. 


For display station errors, call $NUPD so user 
program gets a permanent error return code. 


For vary off, call $NUPD to sign off the display 
Station pass-through TUB. 


For vary off, stop outstanding invites on display 
station pass-through TUBs. 


End of task if no display station pass-through TUBs 
remain. 


For abnormal termination, vary off all display station 
pass-through TUBs. 
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Chart 9.9.2 Target Display Station Pass-Through Support Control Flow 
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SUPPORT SUBFUNCTION FOR THE LAN 


The Communications SSP feature for the local area 
network (LAN) for System/36 enables an application 
program running under the System/36 SSP to 
communicate with work stations and other systems 
through an IBM Token-Ring Network. The programming 
support works in conjunction with up to two local area 
network adapter cards located in either the console IBM 
PC (5364) or a channel-attached IBM Personal Computer 
AT® controller (5360/62). When used to communicate 
over the IBM Token-Ring Network, the programming for 
the LAN conforms to IEEE 802.2 and IEEE 802.5. 


System/36 can communicate with up to 50 link stations 
(work stations and other systems) on each adapter card. 
The communicating link stations can be a mixture of 
primary and negotiable link stations. 


The user application does not directly access the 
programming of the LAN. Instead, the programming of 
the LAN is accessed via an applicable SNA task. The 
SNA tasks access the programming of the LAN via the 
DLC resident interface (#SDRI), and all communication 
from the SNA tasks to the resident interface and the 
programming of the LAN is done via communications 
lIOBs. (See Chart 9.2.3.) 


The following SNA tasks are users of the programming 
subfunction for the LAN: 


e Remote work station support (Chart 9.6.0) 
Note: Remote work station support is available 
only when the link station emulates a 327X 
terminal. 


e Link station test (Chart 9.7) 


e C/SNA (for APPC, MSRJE, SNUF, and SNA 3270 
device emulation subsystems) 


®Personal Computer AT is a registered trademark of IBM. 
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Chart 9.10.0 shows the overview control flow for the LAN: 
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Chart 9.10.0 Overview Control Flow of the LAN 
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The LAN uses three data areas in processing IOBs: 


There is a communications specification block (CSB) for 
each line used by the LAN. Each CSB has a CSB 
extension called the common area that contains status 
information for the respective line. 


The SNA list contains entries for each of the SNAs that 
is communicating. It is pointed to by the CSB. The SNA 
list contains a status entry for each SNA using the line 
and possibly a list of IOBs that are awaiting completion 
of the enable. These entries are chained together and 
contain status information for the SNA such as whether 
or not its line enable has completed. 


The line queue contains all IOBs issued to the control 
storage microcode of the LAN. The line queues (one per 
line) are contained in SCA and are pointed to by queue 
headers. 


Note: An IOB on the transmit or line queue causes 
control flow to or from control storage as shown in 
Chart 9.10.0. In this and subsequent control flow charts 
for the LAN, these queues are shown receiving and 
passing control. This is done to simplify the control 
flow chart and should in no way imply that the queues 
contain free-standing, executable code. 


The LAN consists of three basic parts: 


e Initialization/termination task of the LAN (Charts 
9.10.1.1 and 9.10.1.2) 


e SNA-to-DLC resident interface (Chart 9.2.3) 


e Abnormal termination routines of the LAN (Chart 
9.10.3) 


Initialization/Termination Task of the LAN 

The initialization/termination task of the LAN performs 
initialization and termination processing for the LAN as 
well as message handling for the LAN. It is a swappable 


task. 


The following initialization processes of the LAN are 
shown in event sequence in Chart 9.10.1.1: 


1. Perform initial processing of line open request; get 
SNA-to-DLC resident interface loaded. (#SDRI 
contains code that loads the resident interface 


routine.) 


2 Allocate the line and CSB and assign read and 
internal IOBs. 


3 Return line open parameter list complete. 
4 Process transmit |OB containing enable command. 
5 If necessary, queue IOBs FIFO to the SNA list. 


6 Issue download |IOB to download personal computer 
controller. 


7 Post download IOB complete to initialization/ 
termination task of the LAN. 


8 If any of the following conditions exist, issue a 
message: 


e Initial diagnostic failure 
e Personal computer not powered on 


9 Issue reserved read JOB and process enable 
command. 
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10 Post enable IOB complete to initialization/ 24 Reprocess XID command. 
termination task of the LAN. 
25 At any time in above sequence, process errors 
11. If any of the following conditions exist, issue a requiring abnormal termination. 
message: 
¢ Personal computer adapter malfunction 
e Local name conflict 
¢ Configuration of the LAN invalid 
¢ Controller resource not available 
e Unusual network condition 
12 Post enable IOB complete to SNA. 


13 If this is the first enable, issue read IOBs. 


14 If necessary, remove IOBs from the SNA list and 
process. 


15 Accept transmit IOB containing open station 
command if it is not already queued to the SNA list. 


16 Process open station command. 


17 Post open station |OB complete to initialization/ 
termination task of the LAN. 


18 If any of the following conditions exist, issue a 
message: 


e Network session limit reached 
e Unusual network condition 
¢ Controller resource not available 
19 Post open station |OB complete to SNA. 
20 Accept transmit IOB containing XID command. 
21 Process XID command. 
22 Accept pended XID if necessary. 


23 Accept request for return of XID command if 
necessary. 
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The following termination processes of the LAN are 
shown in event sequence in Chart 9.10.1.2: 


1 


2 Post SNA with all previously outstanding transmit 
lOBs for disconnected station with request ignored 
return code. 

3 Post disconnect IOB complete to initialization/ 
termination task of the LAN. 

4 Post any pended IOBs complete to the SNA with 
request ignored completion. 

5 Post disconnect IOB complete to SNA. 

6 Process terminate IOB. 

7 Post SNA with all previously outstanding transmit 
lIOBs with request ignored return code. 

8 Post terminate |OB complete to initialization/ 
termination task of the LAN. 

9 Post any pended IOBs complete to the SNA with 
request ignored completion. 

10 Post terminate IOB complete to SNA. 

11 Process terminate/detach IOB. 

12 Post SNA with all previously outstanding transmit 
lOBs with request ignored return code. 

13 Post terminate/detach IOB complete to initialization/ 
termination task of the LAN. 

14 Post any pended IOBs complete to the SNA with 
request ignored completion. 

15 Post terminate/detach |OB complete to SNA. 

16 If this was the last SNA task using the line, issue 
disable IOB. 

17 Deallocate line. 
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Process transmit IOB containing DISCONNECT 
command. 
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Chart 9.10.1.2 Termination of the LAN Control Flow 


Section 2: Data Communications Function El 2-499 
This document contains restricted materials of IBM. LY21-0590-4 
©Copyright IBM Corp. 1983, 1984, 1985, 1986 


Controller Check of the LAN 5 If necessary, post IOBs to SNA with controller 
check completion. 

A controller check of the LAN occurs when initialization/ 

termination of the LAN receives an IOB from IOCH of the 6 Queue IOBs to SNA list FIFO. 

LAN or communications IOCH with a completion code 


of: 7 Issue controller check message. 

e Controller check of the LAN (5360, 5362, or 5364) 8 Accept disable IOCH complete. 

e Cable parity error (5360 or 5362) 9 SNA issues terminate/detach. 

e Adapter check of the LAN (5360 or 5362) 10 Dequeue pended IOBs from SNA list. 

The SRC in the IOB further identifies the cause of the 11 Post lIOBs to SNA with controller check completion. 
error. 


12 Deallocate line of the LAN. 
A controller check is a nonrecoverable error for every 
active line of the LAN in the personal computer. 13 Allocate line for diagnostic wrap test of the system 
adapter of the LAN. 
The following controller check processes of the LAN are 
shown in Chart 9.10.2: 14 Issue wrap test message. 


1 IOCH informs initialization/termination of the LAN of 15 Issue wrap test for 5360 and 5362. 
a controller check condition. 
16 Accept wrap test complete. 
2 Post controller check completion to SNA. 
17 Deallocate line for diagnostic wrap test. 
3 Issue disable IOCH. 
18 Issue wrap test results message and go to end of job. 
4 Accept controller check completions in additional 
lIOBs. 
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Chart 9.10.2 Controller Check of the LAN Control Flow 
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Initialization/Termination Abnormal Termination Task 
of the LAN 


The initialization/termination abnormal termination task 
of the LAN will receive control if: 


e Initialization/termination of the LAN received an IOB 
with an invalid completion code from the IOCH of 
the LAN or communications IOCH. 


e _Initialization/termination of the LAN received an IOB 
from IOCH with an operation code that it was not 
prepared to handle. 


e  Initialization/termination of the LAN received an 
invalid |OB from SNA. 


e A 2K-page failure occurred. 


e _ Initialization/termination of the LAN initiated 
abnormal termination because of some situation 
(other than above) that should never occur. 


Abnormal termination can be evoked from initialization/ 
termination of the LAN when it recognizes a severe 
error. Control storage termination can also recognize an 
abnormal termination error. In both cases, control 
storage termination will load #LNAT in place of #LNIT 
before abnormal termination processing begins. 


The following initialization/termination abnormal 
termination processes of the LAN are shown in Chart 
9.10.3: 


1 Issue abnormal termination message. 


2 Issue disable line IOB for all lines (networks) and 
wait for them to complete. 


3 Post all IOBs from line queue. 


4 Post SNA IOBs with abnormal termination 
completion. 


5 Dequeue SNA IOBs from SNA list. 


6 Post SNA IOBs with abnormal termination 
completion. 


7 Receive terminate/detach from SNA. 


8 Process for terminate/detach. 
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SSP-ICF Function B® SSP-ICF user aids subfunction: Chart 10.5.0 
— SSP-ICF debug Chart 10.5.1 
Note: The descriptions of several separately orderable — SSP-ICF verify Chart 10.5.2 
features are included in this function. The content and 
organization of this function are based solely on IBM SSP-ICF program-to-program 
software ease-of-service considerations. In this and in subsystems subfunction: 
other parts of this manual, the term SSP-/CF is used in — SSP-ICF BSC link control Chart 10.6.1 
describing program components of the SSP-ICF feature — Intra Chart 10.6.2 
as well as components of other program features closely — IMS/IRSS Chart 10.6.3 
related to SSP-ICF. The reader should infer nothing —- CICS Chart 10.6.4 
about the content or packaging of any IBM Sales — BSC CCP Chart 10.6.5 
Features from the content and organization of the — BSCEL Chart 10.6.6 
SSP-ICF function, as presented in this manual. — SNA Upline Facility (SGNUF) Chart 10.6.7 
— Finance Chart 10.6.8 
The SSP-ICF function provides user interfaces that allow — Peer Chart 10.6.9 
application programs on System/36 to communicate — APPC Chart 10.6.10 
with another System/36, System/38, System/34, — APPN Chart 10.6.11.n 
System/3, System/370, and other systems that use — Asynchronous communications Chart 10.6.12 
compatible BSC or SNA/SDLC protocols. It also allows 
two or more programs on the same System/36 to MSRJE support subfunction Chart 10.7.0 
simulate remote interactive communications. — MSRJE BSC interrupt Chart 10.7.1 
handler (main storage) 
The SSP-ICF function consists of the SSP-ICF (SSP — MSRJE BSC subsystem Chart 10.7.2 
Interactive Communications Feature) and other — MSRJE SNA subsystem Chart 10.7.3 
System/36 features. — Reader/console task Chart 10.7.4 
— Printer/punch Chart 10.7.5 
Note: SSP-ICF subfunctions that are used by more than — MSRJE forms control Chart 10.7.6 
one component contain control flow blocks that refer to table utility 
the appropriate subsystem or to the appropriate — MSRJE disk file Chart 10.7.7 
interrupt handler. When you need more information on utility 
one of these blocks, refer to the following subfunction 
list to find the chart reference for the appropriate 3270 support subfunction: Chart 10.8.0 
subsystem or interrupt handler. The term interrupt — BSC 3270 interrupt Chart 10.8.1 
handler, when used in this section, refers only to main handler (main storage) 
storage SSP-ICF interrupt handlers. — BSC 3270 subsystem Chart 10.8.2 
— BSC 3270 display emulation Chart 10.8.3 
This function includes the following SSP-ICF ~ BSC 3270 printer emulation Chart 10.8.4 
subfunctions: — SNA 3270 subsystem Chart 10.8.5 
— SNA 3270 display emulation Chart 10.8.6 
e SSP-ICF data management Chart 10.1 — SNA 3270 printer emulation Chart 10.8.7 
subfunction — SNA 3270 personal computer Chart 10.8.8 
support 
e S$SP-ICF control subfunction Chart 10.2 
e Communications and Systems 
e SSP-ICF enable/disable Chart 10.3. 1 Management (C & SM): 
subfunction — Change management Chart 10.9.1 
— Problem management Chart 10.9.2.n 
e C/SNA subfunction Chart 10.4.0 
e Personal computer support Chart 10.10.n 


subsystem 
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MSRJE I/O Support C&SM User Application Programs or User Aids 
(Charts 10.7.4 and 10.7.5) (Charts 10.9.1 and 10.9.2) (Chart 10.5.0) 
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(Chart 10.1) 
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SSP-ICF DATA MANAGEMENT SUBFUNCTION 


SSP-ICF data management provides the interface 
betv’een application programs and SSP-ICF. 


Note: Although SSP-ICF data management is shown in 
this manual as a separate program module, it actually 
executes as a system transient running under the 
application program task. It passes function requests 
and data from the application program to the applicable 
SSP-ICF subsystem and passes data and data-related 
information from the applicable SSP-ICF subsystem to 
the application program. 


Requests from the application program to SSP-ICF are 
issued to the work station data management router 
(#DWDM) in the form of a transfer SVC instruction with 
XR2 pointing to a DTF, which points to the user’s logical 
buffer. When #DWDM determines that the request is 
valid and is for an SSP-ICF subsystem, it builds a work 
station parameter list (WSPL) from information contained 
in the DTF. (For privileged application programs, the 
request may already be in the form of a WSPL). 
#DWDM passes the WSPL to SSP-ICF data management 
via the fast transfer SVC instruction. SSP-ICF data 
management converts the request in the WSPL to a 
request in an SUB (built at acquire or evoke time) and 
posts the request to the appropriate subsystem via 
SSP-ICF control. If the request was for a no wait-type 
operation, SSP-ICF data management exits to the 
application program with the WSPL or DTF (depending 
upon which was originally passed to the work station 
data management router). If the request was for a 
wait-type operation, SSP-ICF data management waits for 
a post from the subsystem before returning the WSPL 
or DTF to the application program. 


The following processes are shown in Chart 10.1: 

1 Process user program request for a subsystem by 
building a work station parameter list (WSPL) based 
on information contained in the DTF and fast 
transferring to SSP-ICF data management. 


2 Process application program request for a 
subsystem: 


« Check session ID. 


e If required, convert high-level-language request 
to specific subsystem request. 


¢ Check for valid operation code. 


e Convert request in WSPL to equivalent request 
in SUB. 


e Route acquire and get attributes to #ICDC. 
¢ Route the remaining operations to #ICDN. 


Continue processing application program request for 
a subsystem: 


e Route operations other than put, get, and evoke 
to appropriate processors. 


Perform additional required processing for put, get, 
and evoke operations (calling subsystem 
subroutines when necessary): 


¢« Assign required SQS. 

e Map user area and TWS. 

¢ Process output (put or evoke) requests by 
changing the request to the format required by 
the subsystem and assigning and moving data 
from the application program to a TWS and/or 
SQS buffer area. 

« Post the subsystem. 

e On return from subsystem for input (get) 
request, move data from the subsystem TWS 


buffer to the application program buffer. 


When request is processed, exit to application 
program with appropriate completion code. 
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If IDDU request: 
e Check session ID. 


« Convert IDDU communications formats to a 
valid WSPL operation code. 


e For evoke: 

— Assign required SQS and map to user area 
and TWS. 

— Change request to the format required by 
the subsystem; assign and move data from 
the application program to a TWS and/or 
SQS buffer area. 

Process return code and any data returned. 


Process INPUT, OUTPUT, or EVOKE requests. 


If DDM SUB, do not process unless WDMDL bit is 
on or EQJ is requested. Otherwise: 


Post user and subsystem for session termination for 
the following requests: 


e Release. 
e End of step. 
e End of session. 


e End of transaction. 
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11 


12 


Perform session cleanup after termination. 


Process the message when an operation is posted 
with an error return code, by mapping the return 
code to the applicable MIC and performing any 
user-required error recovery. 


Build SUB, post subsystem for acquire operation, 
and wait for subsystem response. 


Process APPC subsystem get-attributes and 
get-status operations. 


Retrieve information for get-attributes and get-status 
operations. 


Process APPN implicit enable. 


When SSP-ICF data management posts the subsystem 
via SSP-ICF control, XR1 contains the wait list 
displacement and XR2 points to the SUB. 
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Chart 10.1 SSP-ICF Data Management Control Flow 
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SSP-ICF CONTROL SUBFUNCTION 


SSP-ICF control contains subroutines that allow SSP-ICF 
subsystems to communicate with SSP-ICF data 
management, the data communications (main storage) 
interrupt handlers, and other SSP and SSP-ICF 
components. 


Note: Although SSP-ICF control is shown in this manual 
as a separate program module, it actually executes as a 
part of the applicable subsystem task. 


Essentially, SSP-ICF control is a wait list that is posted 
by SSP-ICF data management on behalf of the local 
application program or by the appropriate interrupt 
handler on behalf of the remote subsystem, or 
equivalent remote program. These programs post 
SSP-ICF control with XR1 containing the wait list 
displacement and XR2 pointing to the appropriate 
control block. 


When posted and when all pending operations are 
completed, the applicable subsystem task performs the 
operation it is directed to by SSP-ICF control. 


SSP-ICF control resides at logical hex address 1000 in 

the subsystem task, with an optional 2K-byte transient 
area following it at hex 2800. It performs the following 
functions: 


1 Route the subsystem work request to the requested 
SSP-ICF control routine. When subsystem is idle, 
route to wait routine for work. 


2 Route request posted from SSP-ICF enable/disable 
or SSP-ICF data management to the proper 
subsystem function. Give control to the subsystem 
at the address specified in the wait list for the post 
type received. 


3 Manage task work space (TWS) and system queue 
space (SQS). 


4 Start required programs for subsystems by 
scheduling an SVC command request to command 
processor program start. The request, accompanied 
by as many as 508 bytes of data, is attached to 
either an active MRT or to the initiator, which 
processes a procedure Call. 

5 Route for error recovery for subsystems. 

6 Log trace entries for subsystems. 

7 Manage subsystem’s 2K-byte transient area. 

8 Move data from real to translated storage. 

9 Move XSUB to SUB. 

10 Move SUB to XSUB. 


11 Post SSP-ICF data management (post users) for 
subsystem, then return to subsystem. 


12 Post the data link control, then return to subsystem. 


When SSP-ICF control passes control to the applicable 
subsystem for a new XSUB request, XR2 points to the 
XSUB. The XSUB points to the user data in the TWS 
buffer and the BUB (which points to the line buffer) for 
most BSC subsystems, or the SNUB (which points to the 
intermediate buffer) for SDLC subsystems. 
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Chart 10.2 (Part 1 of 2) SSP-ICF Control Control Flow 
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SSP-ICF ENABLE/DISABLE SUBFUNCTION 
Enable 


SSP-ICF enable activates an SSP-ICF subsystem 
configuration and, if appropriate, attaches the subsystem 
and associated communications tasks. Enable builds the 
required subsystem control tables (SCTs) and location 
name elements (LOCs) to activate the subsystem. 

Enable is invoked by the ENABLE procedure. 


The following enable processes are shown in Chart 
10.3.1: 


1 Check the syntax of parameters passed in the 
ENABLE procedure. 


2 If SHOW is specified, review configured subsystem 
parameters by displaying the subsystem 
configuration member. 


3 Read the line member and subsystem member. 
Ensure that members are at current levels and that 
the data matches the data communications features 
in the display station configuration member. 


4 Do the following: 
e« Assign an SCT and add it to the SCT chain. 


« If a single-location subsystem (BSC) is being 
enabled, assign an LOC for the location. 


« Set up a TEB to return control to the 
appropriate subsystem module in the event of 
abnormal termination. 


* For the first enable after IPL, assign the SSP-ICF 
communications area and save its address in 


the SCA. 


e« If trace is active, assign and initialize a trace 
area. 
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On subsequent enables, scan for the active SCT and 
subsystem task ID. Ensure that the line member 
and the subsystem member are the same. Post the 
subsystem. 


If subsystem that allows multiple locations, build an 
LOC for each. If APPC subsystem, assign 
associated SGB(s). 


On the first enable of a subsystem, load and attach 
the appropriate link control task and allocate the 
line. 


On the first enable of a subsystem, load the 
subsystem code and transfer control to SSP-ICF 
control to begin subsystem processing. 
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Disable 


SSP-ICF disable deactivates an SSP-ICF subsystem 
configuration and, if appropriate, detaches the 
subsystem and communications tasks. Disable removes 
the subsystem control tables (SCTs) and location name 
elements (LOCs) to terminate the subsystem and 
associated communications tasks. Disable can be 
invoked by the DISABLE procedure; subsystems can 
also call disable to perform selected disable functions. 


The following disable processes are shown in Chart 
10.3.2: 


1 Check the syntax of parameters passed in the 
DISABLE procedure. 


2 Enqueue the SCT chain; search chain to ensure that 
subsystem is enabled. 


3 Process request for the disabling of a single location 
in the subsystem: 


e Ensure that location is enabled and that disable 
is not in progress. 


e For APPN, call IRACTS (active sessions routine) 
to determine if sessions exist for location. 


e If APPN line disable request, call IRACTS to 
determine if sessions are active for any location 
enabled on the line. 

e If disable request and active sessions exist, 
issue halt and prompt for pend disable, retry 
disable, disable kill, or terminate disable. 

e Flag LOC(s) with disable indication. 


e Issue any required diagnostics. 


4 Post the subsystem to perform additional disable 
processing. 


5 Free LOC: 
¢ Flag SUBs and post users for the location. 
¢ Dequeue LOC chain entry. 
e Free LOC. 


e lf APPC subsystem, free associated SGB(s). 
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If subsystem request is for complete subsystem 
disable, perform the following initial disable 
processing: 

e If disable request and active sessions exist, 
issue halt and prompt for pend disable, retry 
disable, disable kill, or terminate disable. 

¢ Flag SCT with disable indication. 

¢ Flag corresponding SUBs if necessary. 


¢ Dequeue SCT chain entry. 


Post the subsystem to perform additional disable 
processing. 


Do the following for the requesting subsystem: 
e Free phone list. 

e Dequeue and free subsystem LOCs. 

e If APPC subsys:em, free associated SGB(s). 


e Dequeue and free SCT. 


e \f abnormal termination of a completely enabled 
subsystem, process any other subsystem SCTs 


for the same subsystem type. 


¢ If last subsystem of this type, deactivate TEB 
and terminate TB. 


If other lines are still enabled for this subsystem, 
continue processing. 
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Chart 10.3.2 SSP-ICF Disable Control Flow 
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ICF C/SNA SUBFUNCTION C/SNA allows System/36 SNUF, the APPC subsystem, 
SNA 3270 emulation, SNA 3270 PC support, or MSRJE 


Systems Network Architecture (SNA) is a standard by SNA to initiate, communicate with, and terminate 
which IBM designs and builds data communications sessions with a System/370 or equivalent system that 
products. Systems Network Architecture specifies the uses TSP3/FMP3, TSP4/FMP4, or TSP7/FMP19 
protocols (commands and responses) that protocols. The interface between the C/SNA system 
communications products use to transmit a user's data task and the user subsystem is the SNUB. C/SNA 
from one location to another. interfaces to DLC tasks via IOBs. 

C/SNA is one of the subsets of SNA used by A System/36 C/SNA overview is shown below. 


System/36. It is designed to allow user programs to 
send and receive data to and from remote locations in 
much the same way they would send data to or receive 
data from any |/O device on the system. This spares 
the user the task of programming complex data 
communications systems. 


System /370 (or Equivalent Host Systems) 
or T2.1 Peer Systems 


System /36 Communications Adapter 


Appropriate Data Link Control (DLC) 
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System/36 C/SNA Introduction 


System/36 C/SNA consists of the following functional 
SNA layers: 


e Path control (PC) 


e Transmission control: 
— Transmission control/session control (TCSC) 
— Connection point manager (CPM) 
— Common session control (CSC) 


e Data flow control (DFC) 


e NAU (network addressable units) services: 
— LU services manager 
— PU services manager 
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C/SNA Mainline 

Mainline processing uses the task complete queue to 
determine the work to be done. The 

scheduler /dispatcher executes the requests on the 
queue by routing control to the necessary C/SNA 
components. 


The following C/SNA mainline processes are shown in 
Chart 10.4.0: 


1 Process user requests (GNUBs) on the task 
complete queue by routing for appropriate 
processing. 

2 Perform normal data receive/transmit operations. 


3 Process the following: 


e Configuration services requests 
(ACTPU/DACTPU). 


¢ Activate/deactivate session. 
« Reset PU to SSCP session. 
« NOTIFY command. 


e TERM-SELF command. 


4 Process the following C/SNA-detected conditions: 


« Close DLC request. 


« DLC error completion. 


5 Process the following C/SNA-detected conditions: 


e SYSLOG requests via C/SNA. 
e Timer completion. 
« SYSLOG completion. 

6 Process IOBs. 

7 rocess I|OB completions. 


8 Process return code (and data) from C/SNA. 
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SNA User: 
e SNA Upline Facility (Chart 10.6.7) 


e APPC Subsystem (Chart 10.6.10) 
e MSRJE SNA Subsystem (Chart 10.7.3) 
e SNA 3270 PC Support (Chart 10.8.0) 
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Chart 10.4.0 SSP-ICF C/SNA Mainline Control Flow 
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C/SNA Transmit/Receive Normal Flow 4 Build BIU by adding RH to session control (pacing) 


RU received from LU services manager. 
C/SNA transmit/receive normal flow processes data 


passed to/from devices (NAUs) in the System/36 5 Build path information unit (PIU) by adding 
portion of the SNA network. transmission header (TH) to the BIU received from 


data flow control send. 
The following C/SNA transmit/receive normal data 


processes are shown in Chart 10.4.1: 6 Build basic link unit (BLU) by adding link header 
(LH) and link trailer (LT) to BIU; send response 
1. Perform normal data transmit/receive operations: basic link unit (BLU). 
¢ Build request/response units (RUs) for transmit 7 Process path information unit (PIU) from DLC by 
request. interpreting transmission header (TH). 
¢ Interpret request/response units (RUs) for 8 Perform connection point routing for inbound data. 


receive request. 


9 Process session control (pacing) BIU from 
e Post applicable subsystem with completion connection point manager receive. 
code and data. 


10 Process BIU from connection point manager receive 


2 Build basic information unit (BIU) by adding by interpreting RH. 
request/response header (RH) to transmit RU 
received from LU services manager. 11 Process request/response unit (RU) from data flow 
control. 


3 Perform connection point routing for outbound 
requests; process pacing input. 
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SNA User: 
@ SNA Upline Facility (Chart 10.6.7) 


e APPC Subsystem (Chart 10.6.10) 
e MSRJE SNA Subsystem (Chart 10.7.3) 
e SNA 3270 PC Support (Chart 10.8.0) 
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Note: Where two module names are given, the second-listed module performs all processing 
required for APPC subsystem (LU 6.2) support. 
$0590342-2 
Chart 10.4.1 SSP-ICF Transmit/Receive Normal Data Control Flow 
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C/SNA Activate/Deactivate 4 Convert PIU to basic link unit (BLU) by adding link 


header (LH) and link trailer (LT); send BLU. 
C/SNA activate/deactivate processes commands that 


alter the status of devices (NAUs) in the System/36 5 Process transmission header (TH): find NAU 
portion of the SNA network. half-session control block and, if found, pass to 


common session control. 
The following C/SNA activate/deactivate processes are 


shown in Chart 10.4.2: 6 Process request/response header (RH): validate 
command and route to LU services manager or PU 
1. Process activate /deactivate commands or build services manager. 
request/response unit (RU) for any required 
responses. 7 Interpret request/response unit (RU): if response 
required, build and issue; post subsystem, if 
2 If required, build basic information unit (BIU) by applicable. 


adding request/response header (RH) for response 
to RU received from LU/PU services manager. 


3 Convert BIU to path information unit (PIU) by 
adding transmission header (TH). 
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SNA User: 
@ SNA Upline Facility (Chart 10.6.7) 


e APPC Subsystem (Chart 10.6.10) 
e MSRJE SNA Subsystem (Chart 10.7.3) 
e SNA 3270 PC Support (Chart 10.8.0) 
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$0590343-2 


Chart 10.4.2 SSP-ICF C/SNA Activate/Deactivate Control Flow 
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SSP-ICF USER AIDS SUBFUNCTION 
SSP-ICF Debug 


SSP-ICF debug records data in the task work area 
(TWA) for each user-specified SSP-ICF operation. The 
data can be displayed or printed by the user as an aid in 
program debugging. The debug routine, in conjunction 
with SSP-ICF data management trace, intercepts an 
SSP-ICF operation at the data management level and 
records (in the assigned TWA) a 64-byte debug trace 
entry, in addition to the SSP-ICF data management 
64-byte trace entry. The debug trace routine and the 
SSP-ICF data management trace routine (if not already 
loaded) are loaded in system queue space (SQS) by 
SSP-ICF debug mainline. 


The following debug processes are shown in Chart 
10.5.1: 


1 Activate debug trace according to parameters 
received with ICFDEBUG procedure call, print debug 
trace records, and deactivate debug trace recording, 
routing control as required. 


2 If ICFDEBUG ON, allocate task work area and assign 


SOS space for load, and load debug trace and 
SSP-ICF data management trace. 
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3. If ICFDEBUG CRT, do the following: 


e Allocate new task work area (TWA) for 
continuing trace. 


e Get trace entries from old TWA. 
e Build output buffer. 
e« Display trace entries to display station (CRT). 
e Deallocate TWA. 
4 If ICFDEBUG PRINT, do the following: 


e Allocate new task work area (TWA) for 
continuing trace. 


e« Get trace entries from old TWA. 
¢ Build output buffer. 

e Allocate and open printer. 

e Print trace entries. 

e Deallocate TWA. 


5 If ICFDEBUG OFF, deallocate TWA and free 
assigned SOS. 


6 Terminate. 


7 Create 64-byte debug trace entry and return. 
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Chart 10.5.1 SSP-ICF Debug Control Flow 
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SSP-ICF Verify 


SSP-ICF verify uses IBM-supplied application programs 
to verify the operation of communications links set up 
by the user for individual IBM data communications 
features. Verify is evoked with the ICVERIFY system 
procedure which, in addition to invoking the appropriate 
verification program, also sets UPSI switches 1 and 2 
for the following: 


— 


UPSI switch 1 on indicates BSC subsystem. 
UPSI switch 1 off indicates SNA subsystem. 


UPSI switch 2 on indicates the remote program is 
the evoker. 


ICVERIFY 
System 
Procedure 


BSCEL/ Peer 
Subsystem Verify 
($1V01) 


Initiator 


IMS/IRSS and 
IMS--BSC/SNUF 
Subsystems Verify 
(#IVO4) 


Chart 10.5.2 SSP-ICF Verify Control Flow 
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Chart 10.5.2 shows the control flow for verify: 


1 


Evoke ICBSCEL or ICPEER procedure on remote 
system. 


Evoke CCPIVP task on the remote System/3. 
Evoke the CSFE transaction on the remote system. 
Issue IMS /TEST command to echo data. 


Send a 3270 Clear key indication to the remote 
system and process response. 


CCP Subsystem 
Verify 
($1VO2) 


CICS/SNUF/BSC 


3 Subsystem Verify 
($1VO3) 


BSC 3270 
Subsystem Verify 
(#1VO5) 
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SSP-ICF PROGRAM-TO-PROGRAM SUBSYSTEMS 


The SSP-ICF program-to-program subsystems allow 
System/36 programmers to write application programs 
that can communicate locally (Intra subsystem only) or 
remotely with other application programs or system 
programs without being concerned with the unique 
communications protocol of the remote system. They 
include: 


e SSP-ICF Intra subsystem Chart 10.6.2 
¢ SSP-ICF IMS/IRSS Chart 10.6.3 
e SSP-ICF CICS subsystem Chart 10.6.4 
e SSP-ICF BSC CCP subsystem Chart 10.6.5 
e SSP-ICF BSCEL subsystem Chart 10.6.6 


e SSP-ICF SNA Upline Facility (SGNUF) Chart 10.6.7 


subsystem 
e SSP-ICF Finance subsystem Chart 10.6.8 
e SSP-ICF Peer subsystem Chart 10.6.9 
e SSP-ICF APPC subsystem Chart 10.6.10 
e SSP-ICF APPN subsystem Chart 10.6.11.n 


e SSP-ICF Asynchronous subsystem Chart 10.6.12 


This topic also includes SSP-ICF BSC link control (Chart 
10.6.1), which is used by all of the BSC 
program-to-program subsystems listed above. 


The following map shows the storage layout of SSP-ICF 
program-to-program subsystem data areas. Logical 
address hex OOOO is the beginning of storage assigned 
to SSP-ICF: 


SSP-ICF 4K-byte Nucleus 


Hex 0000 - - 

Hex 1000 SSP-ICF Control (Chart 10.2) 
Hex 2800 SSP-ICF 2K-byte Transient Area 
(see note) (Optional) 


Hex 3000 Applicable SSP-ICF Subsystem 
* | Programs 


Variable SSP-ICF Task Work Space and 
Map Area 


Note: The SSP-ICF IMS/IRSS, Peer, SNUF, APPC, and 
APPN subsystems don't use the SSP-ICF transient area. 
Their subsystem programs start at logical hex address 
2800. 


Common Program-to-Program Subsystem Interfaces 


Note: Although the Intra subsystem is an SSP-ICF 
program-to-program subsystem, much of the following 
description of general program-to-program 
communications does not apply to it. 


The application programs written for use with SSP-ICF 
interface with SSP-ICF via SSP-ICF data management. 
Although SSP-ICF data management is described in this 
manual as a separate program module, it actually 
executes as a part of the application program task. It 
passes function requests and data from the application 
program to the applicable SSP-ICF subsystem and 
passes data and data-related information from the 
applicable SSP-ICF subsystem via posts to the 
application program. 


The application tasks interface with the 
program-to-program subsystems via SSP-ICF control. 
Although SSP-ICF control is described in this manual as 
a separate program module, it actually executes as a 
part of the applicable program-to-program subsystem 
task. After executing a request by posting either the 
application program or the data link control task, the 
program-to-program subsystem goes to SSP-ICF 
control's wait routine to await the next request. 


The SSP-ICF program-to-program subsystems generate 
the communications protocol needed to link the local 
application program (via the applicable SSP-ICF 
subsystem or equivalent program at the remote location) 
to the remote application program. 


Program start requests for application programs written 
for use with SSP-ICF can come from the local system, 
via the initiator, or from the remote systems, via 
SSP-ICF procedure start requests. 
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Procedure Start Requests 


All program-to-program subsystems are capable of 
initiating and executing procedure start requests. The 
following description assumes that the procedure start 
request is coming from a remote System/34 or a 
System/36. Requests from other system types would 
pass equivalent requests and control blocks to the local 
system: 


e When issuing a procedure start request, the 
program at the remote system sets up an evoke 
operation code in the work station DTF and builds 
an evoke parameter list that indicates the user ID, 
the user's password, the system library containing 
the procedure, and the procedure name. 


e SSP-ICF data management at the remote system 
puts pointers to the evoke list and the user’s TWS 
buffer into the SUB, then posts SSP-ICF control out 
of its wait. SSP-ICF control branches to the new 
request entry point in the subsystem code. The 
remote subsystem sends the request to the local 
subsystem. 


e The appropriate data link interrupt handler at the 
local System/36 posts SSP-ICF control (part of the 
applicable System/36 subsystem) out of its wait. 
The evoke operation at the remote system is now a 
procedure start request at the System/36. 


e SSP-ICF control ensures that the subsystem is 
enabled, then converts the data in the evoke list to 
a procedure start parameter list, builds an SUB, 
posts the command processor to start the 
procedure, then goes to a wait. 


e The command processor acknowledges the 
successful procedure and program start by posting 
the SUB, and the acknowledgement is routed back 
to the remote application program. 


SSP-ICF BSC Link Control 


Interactive BSC link control support binary synchronous 
communications between the BSC program-to-program 
subsystems and remote BSC systems. It is attached as 
a task by the open routine in #IBHP. As part of the 
task-attach process, the open routine also allocates the 
line, loads the proper microcode, assigns IOBs and work 
areas, and posts the interrupt handler task to enable the 
BSC adapter. After the initial setup, link control gets 
control when an IOB op-ends or when it receives a 
subsystem request post; in this capacity, it serves as a 
main storage interrupt handler. All requests to #IBHL 
come through an #IBHL wait routine. 


Line protocols for SSP-ICF BSC are shown in Appendix 
A: Data Communications Line Protocols. 


The following link control processes are shown in Chart 
10.6.1: 


1. Issue SVC instruction to process an IOB. 
2 Perform IOB op-end processing and error checking 
3 Perform SYSLOG message and response handling 
by posting the applicable subsystem with a 
multipurpose BUB. 
4 Handle subsystem request: 
e GET. 
e PUT. 
e Start monitor mode. 
¢« Cancel (BUB). 
e Clear. 
¢ Select reject. 
e Abort. 


e Terminate (communications line). 


5 Bring up data terminal ready and modem ready for 
enable. 


6 Perform required abnormal termination processing 
based on contents of TEB (TEBWORK): 


e Processor check caused by incorrect subsysten 
input. 


e Line deallocation. 
¢ Termination of subsystem. 


¢ Detachment of link control task (#IBHL). 
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Control Storage 


SSP-ICF BSC Link Control Task 
(#IBHL) 


Enable 
(Chart 10.3) 


SSP-ICF Control 
(Chart 10.2) 


SSP-ICF BSC Asynchronous Error Exit 
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Chart 10.6.1 SSP-ICF BSC Link Control Flow 
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SSP-ICF Intra Subsystem 


The Intra subsystem provides an interactive interface 
between user application programs on the same 
System/36. The Intra subsystem can support multiple 
application programs communicating concurrently. The 
Intra subsystem is generally used for the following 
purposes: 


« To test new interactive communications applications 
without using a communications line (these 


programs may have to be slightly modified later). 


e To allow for program-to-program communication 
within the local system. 
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The following Intra subsystem processes are shown in 
Chart 10.6.2: 


1 Perform first enable of the subsystem. 

2 Perform subsequent enables of the subsystem. 

3 Route for new requests posted to the subsystem 
(individual operation code handler routines post user 
with RTC and data for input operations). 


4 Process abnormal end of session. 


5 Process successful program start post from the 
command processor or scheduler. 


6 Process unsuccessful program start post from the 
command processor or scheduler. 


7 Disable the Intra subsystem. 
8 Process immediate subsystem disable. 


9 Set subsystem processor check on subsystem error. 
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Chart 10.6.2 (Part 1 of 2) SSP-ICF Intra Subsystem Control Flow 
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Chart 10.6.2 (Part 2 of 2) SSP-ICF Intra Subsystem Control Flow 
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SSP-ICF IMS/IRSS The following IMS/IRSS processes are shown in Chart 


10.6.3: 
System/36 IMS/IRSS (Information Management 
System/Intelligent Remote Station Support Subsystem) 1. Enable the subsystem: 
provides support that allows up to 16 concurrent 
sessions between the System/36 and IMS/VS ¢ Allocate storage. 
(Information Management System/ Virtual Storage) over 
a single BSC multipoint line. e Start receive operation. 
IMS/VS views each session as a physical terminal and, 2 Process user requests. 
therefore, must have an associated physical terminal 
address. The address must be defined at IMS/VS and 3 Process procedure start requests from host. 
at the System/36. The user program can request a 
specific physical terminal address on the session OCL 4 Process BSC interrupt handler operation end 
statement or the subsystem can assign an address for requests. 
the session. 


5 Display SYSLOG messages and process message 
The subsystem communicates with IMS/VS through the responses. 


SSP-ICF BSC interrupt handler. 
6 Process BSC interrupt handler abnormal termination. 


7 Perform subsystem disable processing. 
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Chart 10.6.3 (Part 1 of 2) SSP-ICF IMS/IRSS Control Flow 
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Chart 10.6.3 (Part 2 of 2) SSP-ICF IMS/IRSS Control Flow 
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SSP-ICF CICS Subsystem 


The System/36 SSP-ICF binary synchronous 
communications (BSC) Customer Information Control 
System (CICS) Subsystem provides a session interface 
to IBM System/370 CICS/VS or equivalent system. 


The CICS subsystem initializes the required storage 
areas, passes data between the application program and 
the BSC interrupt handler, initiates procedures based on 
data received from the remote system, and informs the 
operators of errors. 


The following CICS subsystem functions are shown in 
Chart 10.6.4: 


1 ‘Initialize, and allocate storage and active session 
table (AST) on enable. 


2  Deallocate storage and AST on disable. 


3 Release session buffers and clean up after 
successful procedure start. 


4 Release session buffers and clean up after 
unsuccessful procedure start. 


5 Cleanup and disable subsystem after interrupt 
handler abnormal termination. 


6 Process user responses to subsystem messages. 


7 Process communications line operations (op ends 
via interrupt handler). 


8 Process new user requests. 
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Chart 10.6.4 (Part 1 of 2) SSP-ICF CICS Subsystem Control Flow 
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(continued) (continued) 
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Chart 10.6.4 (Part 2 of 2) SSP-ICF CICS Subsystem Control Flow 
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SSP-ICF BSC CCP Subsystem 


The System/36 SSP-ICF binary synchronous 
communications (BSC) Communications Control Program 
(CCP) subsystem provides System/36 SSP-ICF with a 
session interface to System/3 Model 15 CCP. 


The CCP subsystem supports an EBCDIC/ASCII 
translation function that allows the user to put and get 
data in EBCDIC which is actually transmitted or received 
in ASCII. 


The the following CCP subsystem processes are shown 
in Chart 10.6.5: 


1. On serious errors, disable all System/36 
communications lines associated with the CCP 


subsystem and shut down the CCP subsystem. 


2 Enable SSP-ICF CCP by processing the ENABLE 
command from System/36 enable ($IENBL). 


3 Disable SSP-ICF CCP by processing the DISABLE 
command from System/36 disable (#IEDS). 


4 Initiate operations after successful procedure 
(program) start from the remote system. 


5 Perform error recovery after an unsuccessful 
procedure (program) start attempt from the remote 


system. 


6 Process after a BSC interrupt handler processor 
check. 


7 Process after issuing a SYSLOG message. 


8 Process after the BSC interrupt handler op ends an 
operation. 


9 Process user-program operation codes. 
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Chart 10.6.5 (Part 1 of 2) SSP-ICF CCP Subsystem Control Flow 
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Chart 10.6.5 (Part 2 of 2) SSP-ICF CCP Subsystem Control Flow 
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SSP-ICF BSCEL Subsystem 


The System/36 SSP-ICF Binary Synchronous 
Communications Equivalence Link (BSCEL) subsystem 
provides System/36 with an interface to another 
System/36, System/38, System/34, System/3, 
System/7, BTAM, TCAM, 3471, Series/1, or other 
system that presents a compatible interface. BSCEL 
supports EBCDIC or ASCII data and provides an 
automatic translation function that allows the application 
to put and get data in EBCDIC which is actually 
transmitted or received in ASCII. The BSCEL subsystem 
supports a variety of data formats including 
variable-length blocked records with a record separator 
or intermediate text block (ITB) separator, blank 
compression or truncation, 3740 multiple files and office 
systems support. 


Line protocols used with SSP-ICF BSCEL are shown in 
Appendix A: Data Communications Line Protocols. 


The following BSCEL subsystem processes are shown in 
Chart 10.6.6: 


1 Process the ENABLE command (via the $IENBL 
utility) to enable the BSCEL subsystem on a specific 
line. 


2 Process application program operation codes. 


3 Process procedure start requests from the remote 
system. 


4 Process requests and op ends from the BSC 
interrupt handler. 


5 Process communications line failures. 


6 Handle messages and responses related to the 
BSCEL task. 


7 When trace is active, log trace entries for the 
BSCEL task. 


8 Process the DISABLE command (via the $IEDS 
utility) to disable the BSCEL subsystem on a 
specific line. 


9 Process BSCEL termination for BSC interrupt 
handler abnormal termination. 


10 Process BSCEL subsystem abnormal termination. 
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Chart 10.6.6 (Part 1 of 3) SSP-ICF BSCEL Subsystem Control Flow 
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Chart 10.6.6 (Part 2 of 3) SSP-ICF BSCEL Subsystem Control Flow 
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Chart 10.6.6 (Part 3 of 3) SSP-ICF BSCEL Subsystem Control Flow 
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SSP-ICF SNA Upline Facility (SNUF) Subsystem The following SNUF subsystem processes are shown in 


Chart 10.6.7: 
The System/36 SSP-ICF SNA Upline Facility (SNUF) 
subsystem provides the SSP-ICF user with a session 1 Prepare for communications with a remote system. 
interface to the host subsystems, IMS/VS and CICS/VS, 
using SNA/SDLC protocols. The host subsystems run 2 Set up a session after successfully processing a 
on System/370-type systems with Virtual program start request. 
Telecommunications Access Method (VTAM). The 
SNUF subsystem uses type-P protocols for sessions 3 Perform error recovery after a program start request 
with IMS/VS and full function logical unit protocols with failure. 
CICS/VS. 


4 Process new requests from user programs. 
Line protocols with SSP-ICF SNUF are shown in 


Appendix A: Data Communications Line Protocols. 5 Terminate communications with a remote host. 


6 Process posts from C/SNA. 


7 Handle program and enable errors. 
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SSP-ICF Finance Subsystem 


The System/36 SSP-ICF Finance subsystem provides 
the support that allows the System/36 user to write 
application programs to communicate with IBM 3601 or 
4701 Finance Controllers and IBM 3694 Document 
Processors. 


Line protocols used with the SSP-ICF Finance subsystem 
are shown in Appendix A: Data Communications Line 
Protocols. 


The following Finance subsystem processes are shown 
in Chart 10.6.8: 


1 Enable SSP-ICF Finance subsystem when control is 
received from System/36 enable ($IENBL). 


Application Program 


SSP-ICF Data 
Management 
(Chart 10.1) 


SSP-ICF SDLC 
Interrupt 
Handler 


SSP-ICF Control 
(Chart 10.2) 
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Disable SSP-ICF Finance subsystem when control is 
received from System/36 disable (#IEDS). 


Initiate operations after successful procedure start 
from the remote system. 


Perform error recovery after an unsuccessful 
procedure start attempt from the remote system. 


Process after issuing a SYSLOG message. 
Process user program operation codes. 
Process after SDLC op ends an operation. 


On serious errors, disable the subsystem. 


Control Storage 
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SSP-ICF Peer Subsystem 


The System/36 SSP-ICF Peer subsystem is SNA support 
that allows the System/36 user to write application 
programs to communicate with other programs on a 
remote System/34 or System/36. The Peer subsystem 
is prerequisite support for the Distributed Disk File 
Facility. 


Line protocols used with the SSP-ICF Peer subsystem 
are shown in Appendix A: Data Communications Line 


Protocols. 


The following Peer subsystem processes are shown in 
Chart 10.6.9: 


1. Prepare for communications with a remote location. 


2 Set up a session after successfully processing a 
program start request. 


3 Perform error recovery after a program start request 
failure. 


4 Process posts of IOBs from SDLC or process 
console queue elements (CQEs) for SYSLOG 
messages. 

5 Process new requests from user programs. 

6 Terminate communications with a remote location. 


7 Process subsystem or enable asynchronous errors. 


8 Post SDLC with appropriate data-to-line, and return 
to calling routine. 
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SSP-ICF Advanced Program-to-Program 
Communications (APPC) Subsystem 


The System/36 advanced program-to-program 
communications (APPC) subsystem provides for 
System/36 connectivity to other systems that support 
SNA LU type 6.2 protocols. 


As described in this topic, the APPC subsystem 
supports application program to application program 
communication and includes support for the System/36 
distributed data management (IDDM), distributed office 
system support, and Display Station Pass-Through 
features. C & SM problem management (alert support) 
also uses the APPC subsystem via a system (SSP-ICF 
control) interface. 


In addition to the DTF interface, application programs 
use the following language-level interfaces to the APPC 


subsystem: 


¢« $$FORMAT contains screen formats used for |/O 
performed during an SSP-ICF session. 


¢ Externally-described data formats are built by IDDU. 


Line protocols used with APPC are shown in Appendix 
A: Data Communications Line Protocols. 


The following APPC subsystem processes are shown in 
Chart 10.6.10: 


1 Process STRTGRP and STOPGRP commands by 
beginning/ending appropriate sessions and 
transactions according to command parameters: 
« Allocate and open work station DTF. 


« Process command parameters. 


« Exchange CNOS commands with remote 
system (parallel-session locations only). 


« Post APPC subsystem. 


e Release session acquired to execute CNOS, and 
terminate. 
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Process remote CNOS command by 
beginning/ending appropriate sessions and 
transactions according to command parameters: 
« Allocate and open work station DTF. 


e Issue an accept operation. 


e Initialize session group block (SGB) and post it 
to the APPC subsystem. 


e Release session acquired to execute CNOS, and 
terminate. 


Route for change-number-of-sessions exchange 
with remote location. 


Process the enable command: 

¢« If entire APPC subsystem is being activated, 
update status of each remote location in the 
specified configuration. 

« If a remote location is being activated, update 
status of that location in the specified 


configuration. 


Set up a session after successfully processing a 
program start request. 


Perform error recovery after a program start request 
failure. 


Process posts from LU service models. 


Process new requests (op-codes) from user 
programs: 


« Verify requested operation is valid. 
e Route for appropriate subsystem processing. 


e Post application program with operation 
complete return code. 
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Build/convert function management header 5 
(FMH5): 


e« If request from local application program, build 
FMH5 to start a process at the remote APPC 
system. . 


e« If request from remote application program, 
convert FMH5 to start a procedure at the local 
APPC subsystem. 


Process posts from C/SNA. 


Send problem management alert data to host on 
PU-to-SSCP flow. 


Process the disable command: 


e If entire APPC subsystem is being deactivated, 
perform deactivation processing for each 
remote location in the specified configuration. 


¢« lf a remote location is being deactivated, issue 
PREPARE TO CLOSELOC and CLOSELOC 
Operations to C/SNA. 


e If the remote location being deactivated is 
sending alerts, inform the alert task. 


Free all SGBs associated with the LOC pointed to 
by XR2 and/or dequeue LOC pointed to by XR2. 


Free and dequeue SCT pointed to by XR2. If there 
are no active subsystem configurations, go to end 


of job. 


Handle program and enable errors. 
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SSP-ICF Advanced Peer-to-Peer Networking (APPN) 


Subsystem 


The System/36 advanced peer-to-peer networking 
(APPN) subsystem provides for System/36 networking 
to other systems that support the APPN protocols. In 
addition, other systems that support SNA LU type 6.2 
protocols can participate as end nodes (not including 
CICS/VS). See the Advanced Peer-to-Peer Networking 
Guide, SC21-9471-0, for more information. 


As described in this topic, the APPN subsystem 
supports application program to application program 
networking and includes support for the System/36 
distributed data management (DDM), distributed office 
system support, and Display Station Pass-Through 
features. 


In addition to the DTF interface, application programs 


The following APPN subsystem processes for a session 
request are shown in Chart 10.6.11.1. 


Note: The numbers on Charts 10.6.11.1 and 10.6.11.2 
indicate steps in each process. 


1 Issue acquire for session not pre-established. 
2 Pass session request. 

3 Post for dynamic route. 

4 Post with request. 


5 Post to check if route is available before searching 
network. 


6 Post with response. If positive, step 13 is 
executed. 


use the following language-level interfaces, which are the 


same as the APPC subsystem: 


¢ $$FORMAT contains screen formats used for |/O 
performed during an SSP-ICF session. 


e Externally described data formats are built by IDDU. 


Line protocols used with APPN are shown in Appendix 
A: Data Communications Line Protocols. 
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7 — If negative, response returns. Post to search for 
resource. 


8 Pass special acquire through subsystem. 


9 Pass responses from remote locations through 
subsystem. 


10 Post with responses from remote locations. 
11 Post with request for route. 
12 Post with response. 


13 Post with positive or negative reply. 
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The APPNINFO procedure provides the user with access 
to information needed for problem determination in an 
APPN network. 

The types of information made available are: 

¢« Session trace 

e Directory of locations 


¢« Network configuration 


The following APPN service functions are shown in 
Chart 10.6.11.2: 


1. Control routed based on the first parameter entered 
on the procedure: 


e NETWORK starts network utility 
e LOCATIONS starts location utility 


e SESSION starts session utility 


2 Request made to dump network information to disk. 


3 Request made to dump location information to disk. 
4 Read session data that was logged by C/SNA. 

5 Retrieve necessary message text. 

6 Process prompts and responses as required. 

7 ~~ Read/write information from/to disk. 

8 Issue any required error messages. 

9 Perform any printing associated with user requests. 


10 Terminate this job step. 
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SSP-ICF Asynchronous Subsystem 


The System/36 SSP-ICF asynchronous subsystem 
provides the support that allows the System/36 user to 
write application programs to communicate with 
asynchronous devices. 


Protocols used with the SSP-ICF asynchronous 
subsystem are defined within the user application 


program. 


The following asynchronous subsystem processes are 
shown in Chart 10.6.12: 


1 Enable SSP-ICF asynchronous subsystem when 
control is received from System/36 enable 


(SIENBL). 


2 Initiate operations after a successful procedure start 
from the remote system. 


3 Perform error recovery after an unsuccessful 
procedure start attempt from the remote system. 


4 Process user program operation codes. 


5 Disable SSP-ICF asynchronous subsystem when 
control is received from System/36 disable (#IEDS). 


6 On serious errors, disable the subsystem. 
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MULTIPLE SESSION REMOTE JOB ENTRY (MSRJE) 
SUPPORT SUBFUNCTION 


The MSRJE support subfunction provides the user with 
comprehensive remote job entry capabilities to a 
System/370-type host system. It includes a command 
interface for reader/console input, and printer/punch 
support that interfaces directly with SSP printer data 
management and SSP disk data management. It also 
contains the support needed to interface with the 
System /36 BSC control storage code and C/SNA, and 
two data-handling utilities. The MSRJE support 
subfunction consists of the following components: 


e MSRJE BSC interrupt handler Chart 10.7.1 


e MSRJE BSC subsystem Chart 10.7.2 

e MSRJE SNA subsystem Chart 10.7.3 

¢ MSRJE reader/console Chart 10.7.4 
support 

« MSRJE printer/punch Chart 10.7.5 
support 

¢ MSRJE forms control table Chart 10.7.6 
utility 

« MSRJE disk file utility Chart 10.7.7 


Line protocols used with MSRJE SNA and BSC support 
are shown in Appendix A: Data Communications Line 
Protocols. 
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MSRJE BSC Interrupt Handler 3 Process SYSLOG message according to response. 


The MSRJE BSC interrupt handler (main storage) 4 Perform initialization subtask termination: 
supports binary synchronous communications between 

the MSRJE subsystem and IBM System/370 or e Post subsystem informing it that line 
equivalent systems. It is transferred to as a task when initialization was successful or unsuccessful. 
the first line is allocated in #RJBP, the BSC subsystem 

protocol module. The protocol module also assigns e If required, finish disable. 

lOBs and the MSRJE BSC block (MBB), and directs the 

line allocate subfunction to load the proper ¢ If required, perform abnormal termination of 
communications microcode. The protocol module then subtask. 

posts the interrupt handler for initialization. After the 

initial setup, the interrupt handler gets control when an 5 Perform termination subtask termination: 

IOB op ends, when the subsystem posts the interrupt 

handler, when a SYSLOG message that was issued by - Post subsystem informing it that line is 

the interrupt handler is answered, and when one of its terminated. 


subtasks goes to end of job. 
e« If required, finish disable. 
The following MSRJE BSC interrupt handler processes 


are shown in Chart 10.7.1: e If required, perform abnormal termination of 


subtask. 

1 At 1OB op-end, check IOB return code and data 
stream for errors and issue the next 6 If required, perform abnormal termination of MSRJE 
communications operation. BSC interrupt handler. 

2 Handle the following subsystem posts: The MSRJE BSC interrupt handler subfunction includes 

an error transient that handles its abnormal termination. 
¢ Post to initialize MBB, and timer, and line |OBs If the interrupt handler or any of its subtasks terminate 
for a communications line. abnormally, all MSRJE BSC sessions are disabled. 


¢« Post to start the initiation subtask (#RUJII) to 
enable the BSC adapter and send logon/signon. 


¢- Post to post |OB containing transmit/receive 
overlay to BSC control storage code to transmit 
data. 


e Post notifying interrupt handler of an available 
reserve buffer. (Reserve buffers are used by the 
interrrupt handler to maintain line activity by 
sending ACKOs. 


e Post to start termination subtask (#RJIT) to 
disable adapter. 


e Post to disable processing and, if last line, go 
to end of job. 
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Multiple Session Remote Job Entry (MSRJE) BSC 
Subsystem 


The MSRJE BSC subsystem is the interface between 
the device tasks and the MSRJE BSC interrupt handler. 
When an input device fills a line buffer, it posts the 
subsystem. The input device is given an empty line 
buffer and the interrupt handler is posted to send the 
full buffer to the host. When a text buffer is received 
from the host, the interrupt handler posts the 
subsystem. The subsystem checks the buffer; if it is for 
the printer/punch task, the subsystem queues the buffer 
to the task for processing, and starts the task if it is not 
active. If the buffer contains a console message, the 
subsystem decompresses the message and sends it to 
the reader/console task (if it is active) and to the history 
file. The subsystem also responds to forms mount 
messages and control sequences received. 


The subsystem also handles initialization and 
termination. The initial ENABLE command causes the 
subsystem to be loaded. The subsystem protocol 
module allocates the line, loads the MSRJE BSC 
interrupt handler (if it is not already loaded), and 
allocates all control blocks and buffers for the 
subsystem. When the first MSRJE procedure for a line 
is entered, the subsystem establishes the connection to 
the host via the MSRJE BSC interrupt handler, then the 
interrupt handler sends the LOGON/SIGNON command 
to the host system. When the delay from the END 
command or the configured delay time has expired, the 
subsystem directs the interrupt handler to send 
LOGOFF/SIGNOFF to the host, thus ending the 
connection. The DISABLE command for the last line 
causes the subsystem and interrupt handler to go to end 
of job. 
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The following MSRJE BSC subsystem functions are 
shown in Chart 10.7.2: 


1 Process ENABLE command for subsequent enables. 

2 Process the DISABLE command from user by 
posting all active device tasks to terminate and 
posting the interrupt handler to disable the line. 

3 Process post of successful program start. 

4 Process post of unsuccessful program start by 
reissuing program start request (for first failure) or 
by issuing a message to the user (for subsequent 


failures). 


5 Process SSP-ICF operation request (in SUB) from 
device task. 


6 Process BSC MSRJE interrupt handler normal 
op-end (data has been received). 


7 Process BSC MSRJE interrupt handler error op-end 
by posting all active tasks to terminate. 


8 Process the following special requests: 
e Timer op end. 
« Command requests. 
e Command responses. 
« Inactive post from last device task on LOC. 
e« Interrupt handler; buffer free. 
¢« Interrupt handler; communications established. 
¢« Interrupt handler; answer disable. 
¢« Interrupt handler; answer disable kill. 
« Interrupt handler; disconnect received. 
Note: In addition to the control flow shown, the 


reader/console and printer/punch tasks can also post 
SSP-ICF control directly. 
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Multiple Session Remote Job Entry (MSRJE) SNA 
Subsystem 


The System/36 MSRJE SNA subsystem provides the 
interface for MSRJE device tasks to host applications 
RES, JES2, JES3, and DOS. The subsystem processes 
enable/disable and activation/deactivation requests, and 
manages all LU-to-LU data in conjunction with C/SNA. 


The following MSRJE SNA subsystem functions are 
shown in Chart 10.7.3: 


1 Process enable command for subsequent enables. 


2 Process the disable command from the user and 
post C/SNA to disable the line. 


3 Process post of successful procedure start. 

4 Process post of unsuccessful procedure start by 
reissuing program start request (for first failure) or 
by issuing a message to the user (for subsequent 


failure). 


5 Process SSP-ICF operation request from device 
task. 


6 Process for the following: 
« C/SNA post to subsystem. 
e Timer op end. 
e REQUEST or RESPONSE post. 


e INACTIVE post from last device task on LOC. 
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MSRJE Reader/Console Task The following MSRJE reader/console processes are 


shown in Chart 10.7.4: 
The MSRJE reader/console (R/C) task is the user 


interface to the MSRJE function. It can be evoked by the 1 At session operation-end, process session request 
// EVOKE OCL statement, run from the JOBO, started or response, or save buffer address. 

by an ICF program, or activated by entering the MSRJE 

procedure statement from a display station. When the 2 Initialize library parameters. 

MSRJE reader/console task is activated by the MSRJE 

procedure statement, it starts the initiation phase with 3 Check readfile parameters on MSRJE procedure for 
the host system. After the initiation phase is completed, errors. 


it processes the following: 


4 Syntax check MSRJE commands entered from 


* Command keys, commands, and data from a work keyboard or from command-capable disk file. 


station keyboard 


5 Process parameters for a LIBRARY command. 
e Data from disk to be placed in buffers (supplied by 


the subsystem) and sent to the host system 6 Process a READFILE command. 
¢ Return codes 7 Display error messages and message requests 
received from the subsystem or the reader/punch 
e Timer time-outs task. 
« Requests and responses from the MSRJE 8 Process all commands other than LIBRARY and 
subsystem and SSP-ICF READFILE. 


9 Close and deallocate files. 


10 Syntax check readfile parameters on MSRJE 
procedure. 


11 Place data into TWS line buffer supplied by 
subsystem. 
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MSRJE Printer/Punch Task 6 For work station operations, do the following: 


The MSRJE printer/punch task creates compressed disk « Get data buffer. 
(CDISK) files, punch files, and print data. The task is 
program-started by the MSRJE BSC or SNA subsystem. ¢ Put negative response. 
The data areas are initialized in #RJOI and control is 
transferred to the output task mainline routine. e Get message reply. 
The mainline routine examines the MSRJE function « Set timer. 
control block and forms control table entries, then 
produces the requested output. 7 Fill output buffer from line buffer received from 
subsystem. 
The following MSRJE printer/punch processes are 
shown in Chart 10.7.5: 8 Write to printer. 
1 Process program start request from subsystem. 9 Write to disk file. 
2 Allocate and open the work station DTF. 10 Close and deallocate printer/disk file. 
3 For work station operations, do the following: 11 Route messages to MSRJE console. 
e Get program load data. Note: If an output data set cannot complete normally 
because the device was canceled, option 2 was 
e Set timer. selected, or a permanent device error occurred, the 
termination transient receives control and the 
4 Get forms control table entry. printer/punch task is terminated. 


5 Allocate and open printer/disk file. 
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MSRJE Forms Control Table Utility 

The MSRJE forms control table utility interactively 
builds, updates, removes, prints, or reviews an indexed 
file containing forms control information and disk file 
creation information. The user evokes the MSRJE forms 
control table utility with the RJTABLE procedure 
command. 


The MSRJE control table utility processes are shown in 
Chart 10.7.6: 


e Check and process the table menu option selected, 
the table name specified, and the table location. 


e Check the return code from special allocate. 
e Set up the opened file for entries. 


e Process the entry type and output selected, and the 
entry name specified. 


e Check and process all prompt displays. 


e Convert character numbers to their binary 
equivalents. 


e Convert binary numbers to their character 
equivalents. 


e Syntax check the table name, file label, procedure 
name, library name, printer ID, and user ID. 


e Process terminating error by dumping and exiting. 


e Place print and punch default entries into the newly 
created table. 


e Print entries from an existing control table file. 
e Print the control table file. 


e Review entries in a control table file. 
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MSRJE Disk File Utility 


The disk file utility creates punch files and printer data 
from compressed disk (CDISK) files created during 
MSRJE sessions. It can be loaded from a work station, 
a procedure, or the job queue. The user specifies the 
CDISK file name on a COPYFILE utility control 
statement (or procedure parameters with the RJFILE 
procedure) along with an optional forms control table. 
The CDISK file can contain multiple datasets of SNA 
and BSC printer and punch data. The disk file utility 
creates a file for each dataset in the CDISK file. The 
user can provide as many COPYFILE statements per job 
step as needed. The END utility control statement 
terminates the utility. 


The following MSRJE disk file utility processes are 
shown in Chart 10.7.7: 


1 Syntax check utility control statements. 
2 Retrieve forms control table entry. 

3 Get SNA data record. 

4 Get BSC data record. 


5 Write punch record to data file or print record to 
data file. 


6 Write print record to printer. 
7 Terminate utility. 
8 Process printer errors. 


9 Process disk errors. 
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3270 SUPPORT SUBFUNCTION 


The 3270 support subfunction allows System/36 and its 
display stations and printers to appear as a 3270 control 
unit with attached devices. (The 3270 device emulation 
translates the 3270 data stream from and to the 5250 
data stream.) Support is provided for attachment to BSC, 
SNA/SDLC, and X.25 networks. When attached to a 
BSC 3270 network, the System/36 appears as a 3271 
Model 2 cluster control unit with attached devices. 
When attached to an SNA/SDLC network, System/36 
appears as a 3274 Model 1C control unit with attached 
devices. Host facilities for this emulation include 
System/370 VM/370 (BSC only), IMS/VS, CICS/VS, 
and TSO, and System/3 Model 15 CCP (BSC only). 


Line protocols used with SNA 3270 (SDLC and X.25) and 
BSC support are shown in Appendix A: Data 
Communications Line Protocols. 


Chart 10.8.0 shows the overview control flow for 
System/36 3270 device emulation. The display and 
printer emulation programs provide BSC and SNA 
terminal support that totally masks the 5250 device and 
causes the terminal to appear to the host system to be a 
3270 device. Each System/36 device operating in 
emulation has its own copy of the applicable emulation 
program. With the exception of enable and disable 
processing, the BSC version of these programs 
interfaces directly with the BSC 3270 interrupt handler. 
User application programs can interface with BSC 3270 
Support via the BSC 3270 subsystem. 


The SNA 3270 personal computer program provides the 


interface between the System/36 SNA 3270 subsystem 
and the EP3278 feature on the personal computer. 
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BSC 3270 Interrupt Handler 


The BSC 3270 interrupt handler (in main storage) 
Supports binary synchronous communications (BSC) 
between the BSC 3270 subsystem and a remote host 
system (for user program interface), or between a BSC 
3270 device emulation task and a remote host system. 
It is attached by the BSC 3270 subsystem protocol 
module (#ITSCP) during enable as a nonswappable task. 
#ITSCP also allocates the line and assigns line buffers 
(in the TWS). The BSC 3270 subsystem posts the 
interrupt handler task to complete the enable. 


The BSC 3270 interrupt handler communicates with the 
BSC 3270 subsystem and the BSC 3270 device 
emulation tasks via the realtime interface table (RIT). For 
more information on the RIT, refer to the Data Areas 
manual. 


BSC 3270 Interrupt Handler Region Map 


The following table shows the location of key data areas 
involved in the BSC 3270 interrupt handler: 


/1000___| BSC3270 interrupt handler (THM) —_ 
15000 [unused space 


Dump 
Address 
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The following BSC 3270 interrupt handler processes are 
shown in Chart 10.8.1: 


1 Process a disable post from the subsystem. 
2 On disable, free IOBs. 
3 Disable the adapter. 


4 Complete enable processing (started by #ITSCP) by 
initializing and assigning |OBs and a work area, 
enabling the line, and posting the subsystem to 
acknowledge the enable request. 


5 Make data terminal and modem ready. 


6 Handle IOB op ends by verifying successful 
completion and routing to the post-task routine. 


7 Update the RIT entry based on the IOB and post 
the task. 


8 Handle task posts by setting up IOB for execution 
by control storage BSC microcode and posting it to 
‘the send-response routine. 


9 Send a response to the host system by issuing an 
SVC instruction to control storage and inserting 
control characters in the data. 


10 Handle time-outs from line or task (posted in |OB 
by control storage). 


11 Perform error recovery by performing retry to limit 
set by configuration, then posting the subsystem to 
issue an error recovery message. 


This document contains restricted materials of IBM. LY21-0590-4 
©Copyright IBM Corp. 1983, 1984, 1985, 1986 


BSC 3270 Interrupt Handler BSC 3270 
(#ITHML) Interrupt Handler 
Asynchronous 
Error Exit 
(#ITHDA) 


BSC 3270 
Subsystem 
(Chart 10.8.2) 


Disable Routine 


Control Storage 


User Application 
Program via 3270 
Subsystem 
(Chart 10.8.2) 


BSC Multipoint 
Microcode 


or 


BSC 3270 Device 
Emulation Tasks 
(Chart 10.8.3 or 
Chart 10.8.4) 


$0590356-1 
Chart 10.8.1 BSC 3270 Interrupt Handler Control Flow 


Section 2: SSP-ICF Function 10 2-587 
This document contains restricted materials of IBM. LY21-0590-4 
©Copyright IBM Corp. 1983, 1984, 1985, 1986 


BSC 3270 (Program Interface) Subsystem 


The System/36 BSC 3270 subsystem performs enable 
and disable for all BSC 3270 support. It also provides 
System/36 user application programs with a BSC 
session interface to a host system using 3270 protocols. 
The BSC 3270 subsystem isolates the System/36 
application program from 3270 device control 
information dependencies. If desired, the application 
programmer can still code with 3270 device control 
information. 


All mainline BSC 3270 subsystem functions (operation 


codes) are processed by the BSC 3270 interrupt handler. 


Requests for these functions, and all status and control 
information relative to the requests, are contained in the 
realtime interface table (RIT) control block in SQS. The 
RIT is the control block interface between the BSC 3270 
subsystem and the BSC 3270 interrupt handler. For 
more information on the RIT, refer to the Data Areas 
manual. 
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BSC 3270 Subsystem Region Map 


The following table shows the locations of key data 
areas involved in the BSC 3270 subsystem: 


Dump 

Address 

(in Hex) Contents 

0800 | Nucleus 
SSP-ICF control 


2800 BSC 3270 subsystem (#ITSPI) 
4800 Task work space for line buffer 


5800 Task work space for program interface 
put or get buffer 


The following BSC 3270 subsystem processes are 
shown in Chart 10.8.2: 


1 Enable subsystem by routing to BSC interrupt 
handler to complete enable. 


2 Handle user operation requests passed in the SUB 
by setting up an RIT accordingly. 


3 Process interrupt handler operation-ends (op ends). 
4 Disable subsystem. 


5 Handle line errors and interrupt handler abnormal 
termination. 
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BSC 3270 Display Emulation 


BSC 3270 display emulation provides the System/36 
user with terminal support for a BSC 3270 network. 


The following BSC 3270 display emulation processes are 
shown in Chart 10.8.3: 


1 Process the EM3270 procedure command. 


2 Recover when error detected by the procedure 
processor. 


3 Initialize a session between a System/36 display 
and the host system by initializing the RIT, verifying 
that the line is enabled, and posting the interrupt 
handler with device ready. 


Initiator 


Termination Exit 
Routine 
(HEMFX) 


EM3270 Procedure 
Processor 

(#EMFP) 

EM3270 Initialization 
Routine 

(HEMAD) 


Work Station Data 
Management 


EM3270 Mainline 


(#EMAX) 


Chart 10.8.3 BSC 3270 Display Emulation Control Flow 
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4 Begin active session mainline processing after 
initialization. 


5 During active session, handle command keys, 
commands, and data from a work station keyboard 
by converting data in #EMAD’'s 5250 buffer, placing 
the 3270-equivalent data in line buffer, and posting 
the interrupt handler. 


6 During active session, handle commands and data 
from the host system by converting 3270 data in 
the line buffer, placing the 5250-equivalent data in 
#EMAD‘s 5250 buffer, and posting work station 
data management. 


7 Perform normal termination of a session. 
8 Perform abnormal termination of a session. 


Note: Because #EMAX is reentrant, there will be only 
one copy of it for all active sessions. 


BSC 3270 
Subsystem 
(Chart 10.8.2) 


Termination Exit 
Routine 
(HEMBX) 


BSC 3270 Interrupt 
Handler 
(Chart 10.8.1) 
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BSC 3270 Printer Emulation 


BSC 3270 printer emulation provides the System/36 
user with terminal support for a BSC 3270 network. 


The following BSC 3270 printer emulation processes are 
shown in Chart 10.8.4: 


1 Process the EM3270 procedure command. 


2 Recover when error detected by the procedure 
processor. 


Initiator 


Termination Exit 
Routine 
(HEMFX) 


EM3270 Procedure 
Processor 
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Chart 10.8.4 BSC 3270 Printer Emulation Control Flow 
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Initialize a session between a System/36 printer 
and the host system by initializing the RIT, verifying 
that the line is enabled, and posting the interrupt 
handler with device ready. 


During active session, handle commands and data 
from the host system by converting 3270 data in 
the line buffer, placing the 5250-equivalent data in 
#EM9D’s 5250 buffer, and posting printer data 
management. 


Perform normal and abnormal termination of a 3270 
device emulation session. 


BSC 3270 
Subsystem 
(Chart 10.8.2) 


BSC 3270 
Interrupt 


Termination Exit 
Routine 
(HEMBX) 


Handler 
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SNA 3270 Subsystem 5 Process the ES3270 procedure by doing the 


following: 
The System/36 SNA 3270 subsystem performs enable, 
disable, initiate, and terminate processing for the SNA ¢ Set up the 3270 display emulation task 
3270 support. (FESAX). 


¢ Build an SNUB, LUSCB, and RIT and assign a 


SNA Subsystem Region Map 4K-byte buffer for the session. 
The following table shows the locations of key data ¢ Post initiation complete to the host system via 
areas involved in the SNA 3270 subsystem: C/SNA and post initiation complete to the 


emulation task. 


Dump 
Address e Return to SSP-ICF control. 


(in Hex) | Contents 


6 Process the EP3270 procedure by doing the 


When active, termination exit routine 
(#IZAET); otherwise, SSP-ICF control 


e Set up the personal computer support task. 


SSP-ICF transient area and disable ¢ Build an SNUB, LUSCB, and RIT, and assign a 
routine (4IZDBL) 4K-byte buffer for the session. 


SNA 3270 subsystem (#IZMNL) ¢ Post initiation complete to the host system via 


C/SNA, and post initiation complete to the 
personal computer support task. 


The following SNA 3270 subsystem functions are 
shown in Chart 10.8.5: 
7 When device is terminated, process data received 
1 Process the ENABLE command from SSP-ICF enable from the host system by sending negative 
(SIENBL) by allocating an RIT and 4K-byte buffer for responses via sense codes in the SNUB and LUSCB. 
each SNA 3270 device configured during the 


CNFIGICF procedure execution. 8 Route for DISABLE command from SSP-ICF disable 


(SIEDS). 


2 Set enable in the LOC and the SCT (subsystem 


control table). 9 Process DISABLE command by freeing the SCT and 


LOC and their associated SNUBs and buffers. 


3 At logon, verify that the bind sent from the host 
system is valid by checking for 3270 parameters in 
the bind request. 


10 Process the ES3270 procedure termination post by 
doing the following: 


¢ Terminate the 3270 display emulation task 


4 During active session, provide interface to the host 
(#ESAX). 


system when data is transmitted or received. 


e Free session SNUB, LUSCB, and buffer. 


e Post termination complete to the host system 
via C/SNA and post termination complete to 
the emulation task. 


e Return to SSP-ICF control. 


11 Handle all abnormal SNA posts or completions; call 
for dump if necessary. On serious errors, terminate 
the SNA 3270 session and disable the SNA 3270 
subsystem. 
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SNA 3270 Display Emulation 


SNA 3270 display emulation provides the System/36 
user with display terminal support in a SNA 3270 
network. 


The following SNA 3270 display emulation processes 
are shown in Chart 10.8.6: 


1 Process the ES3270 procedure command. 


2 Recover when error detected by the procedure 
processor. 


3 Initialize a session between a System /36 display 
and the host system by initializing the RIT, verifying 
that the line is enabled, and posting C/SNA with 
initiation complete. 


4 Begin active session mainline processing after 
initialization and receipt of the bind request from the 
host system. 


5 During active session, handle command keys, 
commands, and data from a work station keyboard 
by converting data in #ESAX’s 5250 buffer, placing 
the 3270-equivalent data in the display buffer, and 
posting work station data management. 


6 During active session, handle commands and data 
from the host system by converting 3270 data in 
the session buffer, placing the 5250-equivalent data 
in the 5250 buffer, and posting work station data 
management. 


7 Process SNA protocol. 
8 Perform normal termination of a session. 
9 Perform abnormal termination of a session. 


Note: Because #ESAX is reentrant, there will be only 
one copy of it for all active sessions. 
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SNA 3270 Printer Emulation 


SNA 3270 printer emulation provides the System/36 
user with printer Support in a SNA 3270 network. 


The following SNA 3270 printer emulation processes are 
shown in Chart 10.8.7: 


1 Process the ES3270 procedure command. 


2 Recover when error detected by the procedure 
processor. 


3 Initialize a session between a System/36 printer 
and the host system by initializing the RIT, verifying 
that the line is enabled, and posting C/SNA with 
initiation complete. 


4 During active session, handle commands and data 
from the host system by converting 3270 data in 
the line buffer, placing the 5250-equivalent data in 
the 5250 buffer, and posting printer data 
management. 


5 Perform SNA 3270 protocol processing for SNA 
character string (SCS) or data stream compatibility 
(DSC) data streams. 


6 Control spooling via continue option. 


7 ~~ Perform normal and abnormal termination of a 
session. 


8 Form logical printer records from the SCS data 
stream. 


Note: Based on the BIND command received, either 
#ES9D or #ESSD will be loaded after logon. 
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SNA 3270 Personal Computer Support 4 Begin active session mainline processing after 
initialization and receipt of the bind request from the 


SNA 3270 personal computer support provides the host system. 

interface between the System/36 SNA 3270 subsystem 

and the EP3278 feature on the personal computer. 5 During active sessions, pass all personal computer 
operations and 3270 data to the SNA 3270 interrupt 

The following SNA 3270 personal computer Support handler. 


processes are shown in Chart 10.8.8: 
6 During active sessions, pass all SNA 3270 interrupt 


1 Process the EP3270 procedure command. handler operations and 3270 data to the personal 
computer. 
2 Recover when error detected by the procedure 
processor. 7 Process SNA protocol. 
3 Initialize a session between a System/36 display 8 Perform normal termination of a session. 
and the host system by initializing the RIT, verifying 
that the line is enabled, verifying that EP3278 is 9 Perform abnormal termination of a session. 
active on the personal computer, and posting 
C/SNA when the initiation is complete. Note: Because #ESPC is reentrant, there will be only 


one copy of it for all active sessions. 
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COMMUNICATIONS AND SYSTEMS 
MANAGEMENT (C & SM) 


System /36 communications and systems management 
(C & SM) support consists of the following: 


« Change management 
« Problem management 
* Remote management 


Note: C & SM change management may be referred to 
elsewhere as distributed systems node executive 
(DSNX); similarly, C & SM problem management may be 
referred to elsewhere as alert Support, and 

C & SM remote management may be referred to as 
distributed host command facility (DHCF). 


Change Management 


The communications and systems management (C & 
SM) change management feature allows users to 
distribute and manage files, libraries, and members in a 
network of System/36s attached to a System/370-type 
system. 


C & SM change management communicates with the 
host system via the SSP-ICF SNUF subsystem, C/SNA, 
and SDLC. All files passed from the host system are in 
the form of data sets. The data set name determines 
data set type (file, library, load member, source member, 
procedure member, or subroutine member) that 
System/36 is to process. 


System/36 change management executes the following 
requests from the host system: 


« Add data set 

« Replace data set 

e Send data set 

« Delete data set 

e Initiate received procedure 


« Inform operator 
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The following C & SM change management functions 
are shown in Chart 10.9.1: 


_ 


Process SNUF subsystem procedure start request. 
2 Process initial accept-input operation. 

3 Perform mainline routing for change management. 
4 Verify user ID and password. 

5 Process received data. 

6 Transmit requested data. 


7 For operations involving files, allocate, open, close, 
and deallocate files as required. 


8 For operations involving library members, find 
library, find member, protect member, delete 
member, and perform puts and gets as required. 


9 Read or write files as required. 

10 Delete files as required. 

11 Issue messages received as a result of an 
inform-operator request from the host system and 
put System/36 change management messages to 


the history file. 


12 Evoke procedures sent by change management with 
an initiate-function request. 


13 Notify change management of completion of a 
procedure started by an initiate-function request. 


14 Perform change management processing required 
when change management is canceled or if 


unrecoverable error occurs. 


15 Terminate this task. 
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Problem Management 


The communications and systems management 
(C & SM) problem management feature allows users to 
set up the System/36 to automatically alert the host 


system about the unavailable status of system hardware. 


It also provides a mechanism for signaling that a loss of 
availability is impending via notification alerts. (The host 
system is a System/370-type system running the 
Network Communications Control Facility (NCCF) and 
the Network Problem Determination Application (NPDA) 
programs. C & SM problem management consists of 
two alert task modules, #CZAT and #CZAE, and an alert 
utility module, $CZUT. 


##MSG1 contains approximately 200 hardware error, 
intervention required, thermal check, and unavailable 
messages that are shipped from IBM with their alert 
generation indicators on. When the alert task is active 
and SYSLOG or the console SYSLOG message builder 
transient (HSVWER) detect that the alert generation 
indicator is on in a message they are issuing, the alert 
task is posted to send an alert to the host in the form of 
a network management vector transport (NMVT RU). 
The NMVT RU is the architected request/response unit 
that carries alert information to the host. 


The alert utility, described later in this topic, allows the 
user to customize the System/36 portion of the 
network's problem management system by modifying 
the alert generation indicator of any alert-capable 
message contained in ##MSG1 and provides the 
interface for sending a notification alert. 


The C & SM problem management alert task is attached 
by the APPC subsystem protocol module when an alert 
location is enabled. The alert task communicates with 
the host system via its special interface (bypassing 
SSP-ICF data management) to the APPC subsystem. 


The following C & SM problem management functions 
are shown in Chart 10.9.2.1: 


1 Process ZO or NO parameter list containing the 
error message that defines alert. 


2 Wait for posts from subsystem or disable request; 


route (based on XR1 value) for processing by 
appropriate routine. 
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Build ZA parameter list (containing the alert address) 
and post it to APPC for transmission on the 
PU-SSCP session. Return to mainline routine. 


Check return code in ZA parameter list on post back 
(alert sent) from APPC subsystem. If line is inactive, 
requeue alert ZO or NO parameter list, then return 
to mainline routine. 


Process remote node active (RNA) post from APPC 
subsystem, then return to mainline routine. 


Process for termination. If no other LOCs are still 
enabled, terminate; otherwise, return to mainline 


routine. 


Perform normal termination or route for alert task 
abnormal termination. 


Perform alert task abnormal termination: 
e Wait for completion of pending requests. 


e Post APPC to disable all enabled C & SM 
LOCs. 


e Issue message to local system console via 
SYSLOG. 


¢ Quiesce all pending events and free SQS. 
e Return to system termination. 


Process LOC disable posts from abnormal 
termination. 
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The alert utility allows a user with system operator or The following C & SM alert utility functions are shown 


higher security classification to access the alert in Chart 10.9.2.2: 
generation indicators in the ##MSG1 system message 
member or in an alert source member for any of the 1 Do the following, routing control where necessary: 


following purposes: 
e Initialize common area. 
« View/print alert generation indicator settings in 
##MSG1 message member. ¢« If security is active, check for proper security 


classification (system operator or above). 
¢« View/print alert generation indicator settings in alert 


source member. « Allocate and open work station DTF. 

¢« Reset alert generation indicator settings in ##MSG1 ¢ Prompt user for function to be performed. 
to those originally set in alert MIC table (AMT) by 
IBM. e Perform requested function. 

e« Apply an alert source member to ##MSG1 to 2 Get message text and alert generation indicator. 


modify the alert generation indicator settings. 


3 Perform any printing associated with user requests. 
e Create, update, copy, remove, or rename an alert 


source member. 4 Process operator prompts and responses, as 
required. 
The alert utility also provides the interface for sending a 
notification alert which allows you to generate your own 5 Reset/modify the alert generation indicator for 
message and send it to the host system that is receiving specified messages in system message member. 
alerts. 


6 Process alert source member: 


« Verify existence of specified library and 
member. 


e Lock member against simultaneous use. 
e Read/write member as required. 

7 \Issue any required error messages. 

8 Send notification alert. 


9 Terminate this job step. 
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Remote Management 


The C & SM remote management (DHCF) feature allows 
3270 users on a host system (through the HCF 
application) to access the System/36 as a remote work 
Station. 


C & SM remote management communicates with the 
host system via the SSP-ICF SNUF subsystem, C/SNA, 
and SDLC. Data passed between System/36 and the 
host system is enveloped within the frame. The 7-byte 
envelope describes the type of operation for HCF and 
DHCF, and carries the device RH, some relevant TH bits, 
and the sequence numbers. 


While the 3270 is attached to a DHCF session, all 
normal commands, procedures, and applications can be 
accessed on the System/36 as if the 3270 device were 
a 5250 remote device. 


The following C & SM remote management functions 
are shown in Chart 10.9.3: 


1 Process SNUF subsystem procedure start request. 
2 Process initial accept input function. 
3 Perform session bring-up and device bring-up. 


4 Process received data. Data stream translation 
3270-5250. 
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5 Process data to be transmitted. Data stream 
translation 5250-3270. 


6 Interface to work station data management for 
outbound data. 


7 Interface to work station data management for 
inbound data. 


8 Save and restore screen data to/from disk. 
9 Interface to SNUPD for error handling. 
10 Issue messages. 


11 Perform processing required when session is 
canceled by either System/36 or host. 


12 Perform termination when the last session is 
canceled. 


13 Perform keyboard map functions (display, change) 
initiated from keys procedure. 


This document contains restricted materials of IBM. LY21-O0590-4 
©Copyright IBM Corp. 1983, 1984, 1985, 1986 


SSP-ICF SNUF 
Subsystem 
(Chart 10.6.7) 


Initiator 


Bring-up 
(#HCVY) SSP-ICF Data 


Management 
Work Station 


Data Management 


(Chart 10.1) 


3270-5250 
Translate 
(AHCIN) 


5250-3270 
Translate 
(HHCOUT) 


Command 


Remote 
Processor 


Management 
Mainline 


Disk Data 


Management 
(#HCML) g 
g Error Processing 
(SNUPD) 
10 SYSLOG 


Session Take-Down 
(HHCER) 


Keyboard Map 
Management 


(#HCKB) Termination 


S0590446-2 


Chart 10.9.3 Remote Management Control Flow 


Section 2: SSP-ICF Function 1.0} 2-607 
This document contains restricted materials of IBM. LY21-0590-4 
©Copyright IBM Corp. 1983, 1984, 1985, 1986 


PERSONAL COMPUTER SUPPORT SUBSYSTEM 
6 Perform one of the following operations: 
The personal computer support subsystem provides 


server functions to personal computers that are attached ¢« Display-buffer-sent 

to a System/36 via a 5250 emulation program or via the 

IBM Token-Ring Network. e  Display-buffer-received 

The following personal computer support subsystem ¢« Display-buffer-sent-received 
processes for a 5250 environment are shown in Chart 

10.10. 1: ¢« Display-buffer-received-not-sent 
1 Perform the SSP-ICF control program start or post e SSP-ICF-post-received 


user task subroutine. 
7 — Issue operations. 
2 Perform the SSP-ICF control wait subroutine. 
SSP-ICF control branches to the defined entry 8 Read or write a virtual disk. 
points in the router to fall out of the wait. 
9 Issue printer operations. 
3 Post SSP-ICF control with data received. 
10 Issue query operations. 
4 Transfer termination to the router termination entry 
point. 


5 Perform one of the following router subroutines: 
e  Put-display-buffer 
e Get-display-buffer 
¢ Wait 


«  Terminate-conversation 
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The following personal computer support subsystem 
processes for an environment of the LAN are shown in 
Chart 10.10.2: 


1 Perform the SSP-ICF control program or post user 
task subroutine. 


2 Perform the SSP-ICF control wait subroutine. 
SSP-ICF control branches to the defined entry 
points in the router to fall out of the wait. 

3 Perform one of the following router subroutines: 
¢  Put-display-buffer 
e Get-display-buffer 
e Wait 
¢ Terminate-conversation 

4 Perform one of the following operations: 
¢  Display-buffer-sent 
e Display-buffer-received 
e Display-buffer-sent-received 
¢« Display-buffer-received-not-sent 
e SSP-ICF-post-received 


5 Issue operations. 
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This section describes interfaces between the SSP and 
other IBM-supplied programming. The interface 
descriptions are intended for use in isolating a 
suspected control storage, programming language, or 
Utilities Program Product problem from an SSP problem, 
for the purposes of writing an accurate APAR. 

For information on the control blocks and data areas 
used in this section, refer to the System Data Areas 
manual. 

The following interfaces are described: 

¢ SSP to control storage 

e SSP intermodule 

e SSP to overlay linkage editor 

¢ SSP to sort utility 

¢ SSP to Ideographic Generator/Sort Program Product 
¢ SSP to language program products 

e SSP to Utilities Program Product 

e SSP to OFFICE/36 

¢ SSP to Development Support Utility 

Reverse numbers in the text in this section (3 | for 


example) refer to major function descriptions in 
Section 2: System Function/Control Flow. 


Section 3: SSP Programming Interfaces 


Section 3: SSP Programming Interfaces 3-1 
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SSP to Control Storage Interfaces 


The following SSP to control storage main interfaces are 
described: 


¢ Control storage executable code 
— SVC instruction 
— XFER instruction 


¢ Control storage data areas (located in main storage) 
— System queue header area 
— System communications area 


SSP TO CONTROL STORAGE EXECUTABLE CODE 


SVC (Supervisor Call) Instructions 


The SVC instruction (op code hex F4) is the basic SSP 
interface to control storage and is used by all executable 
code in main storage. Main storage programs, either at 
the machine language or assembler level, use the SVC 
instruction to request control storage functions. When 
an SVC instruction is encountered in the instruction 
stream, main storage processing is halted, main storage 
registers are saved by hardware, and the control storage 
entry routine (operating at a dedicated interrupt level) is 
started and determines what operation has been 
requested. The operation is determined by the Q-byte 
and R-byte of the SVC instruction and parameters that 
are passed with the instruction. Based on the SVC 
request operation, the entry routine determines if the 
operation is valid and if it is to be executed immediately 
or processed in overlapped or delayed mode. 


If the SVC instruction is to be executed immediately, the 
main storage processor remains stopped, and the entry 
routine gives control to the immediate SVC routine to 
perform the requested function. After the function has 
been performed, the immediate SVC routine returns 
control to the entry routine which restarts the main 
storage processor. The main storage processor resumes 
processing at the next instruction either of the current 
task or, if a task switch has occurred, of a different 
task. 
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If the SVC instruction is to be processed in overlapped 
or delayed mode, the entry routine determines if another 
task can be run; if another task is ready, the entry 
routine requests the SVC processor, then starts the main 
storage processor which causes the MSP hardware to 
load the registers of the main storage processor for a 
different task, if possible, and exits the entry routine. 
Overlapped or delayed functions receive control on the 
main program level and are used either to control data 
flow between main or control storage and the 1/0 
devices or to maintain control information. 


For more information on this interface, refer to the 
Control Storage Service Information manual. 


XFER (Transfer) Instruction 


The XFER instruction (op code hex F5) is a request for 
specialized control storage functions. When the main 
storage processor attempts to execute the transfer 
instruction, it is stopped; it is not started again for the 
current task until the specialized control storage 
processing is completed (it can be started for the 
execution of a different task). The control storage entry 
routine requests the extended control storage (ECS) 
processor to execute the transfer instruction. 


The extended control storage (ECS) processor, operating 
on the control storage processor main interrupt level, 
receives control and executes the instruction on the 
main program level. 


After determining that the Q-byte of the transfer 
instruction is valid, the ECS processor uses the Q-byte 
to determine whether the instruction is from a BASIC or 
a FORTRAN program and passes control to either the 
scientific instruction set interpreter or the BASIC 
instruction set emulator. 


For more information on this interface, refer to the 
Control Storage Service Information manual. 
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SSP TO CONTROL STORAGE DATA AREAS 


‘System Queue Header Area 


The system queue header area is located at hex OBOO of 
the main storage fixed nucleus and contains 1024 bytes. 
Each queue header contains a 3-byte address of the 
first associated element of a chain. Each chain 
represents work to be done by various system 
components or resources used by the components. 


The system queue header area serves as the main 
work-unit interface between the main storage and 
control storage processors. Work unit elements (control 
blocks) required for main storage task execution are 
chained to the various queues by main and control 
storage. When control storage executes a work unit 
requested in a queue element, it removes that element 
from the chain. 


For more information on this interface, refer to Queue 
Header Area in the System Data Areas manual. 


System Communications Area 


The system communications area is a /68-byte common 
area that is used by various components of the SSP to 
communicate with each other. It contains configuration 
data, addresses (disk and main storage) of system areas 
as well as other system information. 


The system communications area is located in the fixed 
nucleus starting at hex 0800 of main storage. 


For more information on this interface, refer to System 
Communications Area in the System Data Areas manual. 
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SSP Intermodule Interfaces 


The following SSP intermodule interfaces are described 
in the following text: 


e System interlocks 
e Program types 
« Program attributes 


e Program control 


Subtasking 


SYSTEM INTERLOCKS 

The System/36 multitask environment requires system 
interlocks to prevent the simultaneous use of certain 
system resources by two or more tasks. The initiator 
is the primary component ensuring that resources are 
properly interlocked. It obtains these resources by 
setting the interlocks in the task blocks or queue 
headers, usually via the resource enqueue and resource 
dequeue SVC instructions. For locations of the following 
interlocks, see Task Block and Queue Header Area in the 
System Data Areas manual: 

e System trace 

e Console SYSLOG 

e Reject file 

e Dedication 

e Scheduler 

¢« VTOC (includes main storage format 1's) 

« Format 5 

e Procedure name 

e History file 

e Multiple SNA line 

e Spool file 


e Messages file 


¢ Security utility 
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e User ID file 

e Resource utility 

e Resource security file 

e CONFIG record 

e MRT termination 

e File modify 

« Address compare dump 

« SCT queue 

e MSRJE 

e TUB chain interlock (in SCA) 
e Procedure parameter save area 
e Job control block 

e ERP interlock 


e Spellcheck 


PROGRAM TYPES 


Resident programs are loaded during initial program load 
and are present at all times in the fixed nucleus. 


Transient programs are reusable (see Program Attributes) 
and run in the System/36 transient area (a 4K-byte area 
starting at address hex 001000). 


Both resident and transient programs can be addressed 
using real instruction addressing. 


Translated programs are those for which address 
translation is used for instruction addressing. These 
programs can be executed anywhere in main storage 
and do not require contiguous pages of storage. 
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PROGRAM ATTRIBUTES 


The following attributes define bits in the IDMAC bytes 
of each SSP program: 


Reentrant Program: Multiple tasks can execute 
concurrently within a reentrant program. With more than 
one task using the same code, it is essential that data 
relevant to specific tasks be stored somewhere other 
than in the reentrant program. Because the dispatcher 
can preempt a reentrant program at any soft stop point 
to allow another task to execute it or to take its storage 
(without writing it to the swap area), the program must 
be designed to be refreshable at all soft stop points (see 
Soft Stop). When the program needs storage again the 
reentrant program is read in from its library. 


Reusable Program: Multiple tasks can execute a 
reusable program but, because the code can be altered 
during execution, it must be reinitialized with each use. 
The dispatcher assumes it can preempt a reusable 
program at any refreshable wait point by releasing its 
storage without writing it to the swap area. A 
refreshable wait point is a point in the reusable program 
at which no data dependencies exist; the supervisor can 
read in a new copy of the program from the appropriate 
library, with the ownership of the program possibly 
changing to a different task. 


Single Copy: A program that cannot be shared by 
multiple tasks; each using task has its own copy of the 
program. When its storage is taken, the single copy 
program must be written to the swap area. 


Soft Stop: A hardware function requested by control 
storage when a task switch is necessary. Soft stop can 
occur at logical breakpoints in a program such as true 
branch or jump backward conditions, SVC instructions, 
transfer instructions, or the loading of the IAR for any 
purposes. Because a task switch can occur at any soft 
stop point, the supervisor stops the main storage 
processor and may start up another task. 


Swap Required: When taking storage from a 
swap-required program, the supervisor must write the 
current copy of the program to the swap area before 
releasing its storage. 


Pinned Program: The supervisor cannot release the 
storage of a pinned program. 


PROGRAM CONTROL 


On System/36, programs receive control by either the 
load or the transfer supervisor call instruction. The 
programs evoked by LOAD-RUN OCL statements are 
started as tasks by #SVAT, the task-attach function. 
The attach function either loads or transfers to the 
program. 


Programs evoked via transfer receive control either via 
transfer by ID or by disk sector address. On a transfer 
by ID, the program always receives control at its load 
address; other than at IPL time, resident programs are 
always called by ID. A nonresident program may be 
requested using an ID, if one is defined, or it may be 
called via sector address. If the transfer is by sector 
address, an entry point table may be used to specify a 
start control address other than the program load 
address. An entry point number other than O indicates 
that an entry point table is to be used. If an entry point 
table is used, the value of the ENTRY parameter, minus 
1, times 2, is the displacement into the entry point table 
where the start control address is contained. 


Resident programs and transient programs occupy real 
addressable storage locations. Except during IPL time, 
resident programs are transferred to by ID; transient 
programs receive control via transfer either by ID or by 
sector. 


Nonresident programs are loaded when needed, and are 
present as long as the storage they occupy is not 
needed by a higher priority task. They can execute 
anywhere in main storage and do not require contiguous 
pages of main storage; these are translated programs. 
Control is passed to them by transfer either by ID or by 
sector address. 


For more information on program control, refer to 


Program Management in the Control Storage Service 
Information manual. 
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SUBTASKING 


Subtasking allows SSP modules to execute 
subroutine-equivalent tasks (subtasks) in parallel. An 
asynchronously executing subtask does not return 
control to the originating task in the normal subroutine 
manner, but it can post the originating task during 
execution; on subtask termination, control storage 
termination posts the parent task if the transfer request 
specified RETURN-YES. 


For more information on subtasking, refer to Program 
Management in the Control Storage Service Information 
manual. 
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SSP to Overlay Linkage Editor 
Interfaces 


The overlay linkage editor (OLE) can be entered two 
ways: compiler entry, directly from a language 
processor; or user entry, from the OCL load statement. 
The following routines are used by OLE for |/O 
interfaces: 


« Compiler access method (CAM) macroinstruction, 
using control storage disk IOS to get or put sectors of 
$SWORK and $SOURCE files. 


« Find library F1 address 6 | to find library sector 
address. 


e Librarian find routine Gi to read subroutine and load 
members from a library. 


« Librarian sector get/put routine 6 | to write subroutine 
and load members into a library. 


« Printer data management 4 | to print messages, map 
storage, and cross reference print data. 


« Disk DTF data management 4 | to write messages to 
the diagnosed source file. 


If OCL statements are used to evoke OLE, OLE calls the 
syntax checker 6 | to check the syntax of the control 
statements. It calls allocate or special allocate to 
allocate $WORK and $SOURCE files. 
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SSP to Sort Utility 


The sort utility is part of the base SSP. This utility may 
be evoked in the following ways: 


« User-written OCL statements to load and run the 
#GSORT program. 


¢ SORT procedure. 


e Transfer supervisor call (SVC) instruction directly from 
a user-written COBOL or assembler program. 


The sort utility supports the $SRT and the $SORT 
macroinstructions in the Assembler and Macro 
Processor Program Product. The $SRT macroinstruction 
generates a sort parameter list; the $SORT 
macroinstruction generates an SVC instruction to call the 
sort utility from an assembler program. 


When a user program calls the sort utility directly by 
using a transfer SVC instruction, the #GSLS module 
runs in the system transient area. This module then 
transfers control to the first sort module (fGSORT). The 
#GSLS module varies the program size depending on 
available storage, the minimum sort design point (18K 
bytes), and the program size of the caller. This same 
sort module also sets itself up as a termination exit 
routine so that it receives control if sort terminates 
abnormally. Control can then be returned to the user 
with a success or failure indication. 


Setup Phase 


For the first step in sorting, the program reads the sort 
specifications, generates code for selecting the records 
to be sorted, and builds the appropriate work record. 
The sort utility uses the following system interfaces 
during the setup phase: 


e If called from a user program, use control storage 
mapping to map the user parameter list to the sort 
program area. 


e Member find Gi to find the sort message member 
(#4GS#MM) and set the program level 1 message 
member pointer in the job control block to that 
member. 


e Disk VTOC read/write Gi to read the format 1’s for 
the input, work and output files. From this 
information, the sort utility can determine the number 
of input files, the number of records in the input file, 
the input file record length, whether or not a user 
WORK FILE statement was specified, and whether or 
not the output file overlaps an input file. 


e Allocate to allocate the sort work file if the user 
specifies a FILE statement with a NAME-WORK 
parameter. Otherwise, special allocate to allocate a 
disk area large enough to process the input. 


e SYSIN 6 | to read sort specifications if they are inline 
in the procedure. 


e Source get 6 if sort specifications are in a source 
member. 


e Message retrieve 6 | to retrieve sort error and 
informational messages from the sort message 
member. 


e SYSLIST 6 | to print specifications, status, and errors. 


Execution Phases 


These phases read the input file(s) and write work 
records into the work file. The work records are sorted 
and then written into the output file. The sort utility 
uses the following system interfaces during the 
execution phases: 


e Allocate 6 J open 6 | and close for all input and 
output files. 


« Deallocate for input files as they are read. 


¢ Consecutive get disk data management 4 | to read the 
input file(s) and consecutive put disk data managemeni 
to write the output file. 


¢ Control storage disk IOS to read and write work 
records in the work file and to clear the work file 
area to zeros at the end of sort. 


« SYSLOG Gi to write error or informational messages 
requiring a response. 
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SSP to Ideographic Utilities 


CHARACTER GENERATOR UTILITY 


The character generator utility allows the user to create 


and maintain a file of ideographic characters that are not 


contained in the IBM-supplied extended ideographic 


character set for System/36. The character generator is 


evoked with the CGU procedure. 


The SSP initiator [Ef loads #CGIN to initialize for 
character generation. 


The utility uses SSP special allocate to allocate the 
following files: 


¢ #EXTN, #EXT1818, and #EXT2424 files contain 
matrix patterns for the extended ideographic 
character set, the character generator utility special 
characters, and the user-defined characters. 


« #KAMAST file, contains master sort information for 
all |IBM-supplied ideographic characters and 
user-defined characters. 


¢ #KACTIVE file, contains active collating sort 
information for all ideographic characters. 


SSP SYSLOG [Mf receives control from any of the 
character generation utility modules to issue messages 
and prompt for operator options. 


SSP termination receives control from #CGML to 
terminate the character generator utility. 


IDEOGRAPHIC SORT UTILITY 


The ideographic sort utility can sort up to eight disk files 
by one of three methods: (1) addrout sort, (2) tagalong 
sort, or (3) summary tagalong sort. The ideographic sort 
is invoked by the SRTX procedure. 


The SSP initiator [Ef toads #CGIN to initialize for 
character generation. 


The utility uses SSP special allocate to allocate the 
following files: 


« #KAMAST file, contains master sort information for 
all ideographic characters and user-defined 
characters. 


« #KACTIVE file, contains active collating sort 
information for all ideographic characters. 


SSP SYSLOG Ga receives control from any of the sort 
utility modules to issue messages and prompt for 


Operator responses. 


SSP termination receives control from #KA4A or 
from #KATB to terminate the sort utility. 
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SSP to Language Program Product 
Interfaces 


This section describes the language program product 
interfaces to the SSP. For information on the language 
program product execution-time and compile-time 
modules, refer to Appendix B: Programming Language 
Directory. 


The following SSP to language program product 
interfaces are described: 


e RPG 
~— Compile-time interfaces 
— Execution-time interfaces 


e« BASIC 


e COBOL 
— Compile-time interfaces 
— Execution-time interfaces 


e FORTRAN 
— Compile-time interfaces 


— Execution-time interfaces 


e Assembler Language and Macro Processor 


SSP TO RPG INTERFACES 


Compile-Time Interfaces 


The RPG compiler uses the following interfaces to SSP 
and system functions: 


¢« Compiler information block (CIB): The CIB is a 
system block created by the initiator when a 
compilation is requested. The compiler extracts the 
modification reference number, date, and time from 
the CIB for the compiler prologue. The compiler also 
places information into the CIB (the current system 
date and time, the library submember type, the 
compiler work file extents, and the region size 
available) for later processing by the overlay linkage 
editor. The compiler reads/writes the CIB using 
information retrieval rH. 


« System local data area (LDA): The system LDA is 
used to pass the parameters from the compiler 
procedures to the compiler. The compiler 
reads/writes this area using information retrieval Gi. 


¢« Work file |OBs: The auto report function of the RPG 

compiler uses the compiler access method (CAM) 
macroinstruction to access compiler work files. CAM 
uses the IOB as input to contro! storage disk IOS, 
which reads/writes the files. The rest of the compiler 
accesses the $SOURCE and the $WORK files without 
the use of CAM, by updating the IOB and calling disk 
lOS directly. 


¢ Define the file (DIF): If a diagnosed source member 
was requested, the compiler uses open and 
allocate to prepare another work file (GSWORK2) 
using the DTF control block. Input and output to the 
file are performed with the $GETD and $PUTD 
macroinstructions (disk data management EZ). 


« $WORK file: The compiler passes the generated 
object program to the overlay linkage editor in the 
SWORK file. 


« Where-to-go table: Each of 13 RPG compiler modules 
contain a where-to-go table, which contains entries 
for each of the next several phases to be executed. 
The compiler routine that calls the next phase uses a 
where-to-go table entry as the loader parameter list. 
This table is updated automatically by the 
cross-reference resolver Gi whenever library 
maintenance takes place in the #RPGLIB library. 
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Execution-Time Interfaces 


The following RPG II data areas can be accessed by 
SSP whenever an RPG II user program is executed: 


« Reserved object communications area (ROCA): A 


reserved data area that is contained in the first 256 
bytes of the root segment of every RPG II object 
program. SSP accesses the indicator table, which 
contains an entry for every possible RPG II indicator. 


Define the file (DTF): The DTF is the primary external 
interface to data management. The program contains 
a preopen DTF for each file specified by the program. 
When the program is executed, the job start function 
modifies the preopen DTFs and returns them as 
post-opened DITFs. 


After external requests have been made (generally to 
the data management function 4 Fl the data 
communications function EI or the SSP-ICF 
function i). the requested SSP function sets the 
postopen DTF completion code and returns the DTF. 


After a DTF is opened, the following system 
macroinstructions are used for |/O to the file: 


¢ $GETD and $PUTD—Disk data management gi 
¢ $PUTP-—Printer data management 4 | 

¢ $GETB and $PUTB—BSC data management Ey 
« $WSIO-Work station data management 4 


Input and output buffers: Every RPG program 
specifies an input buffer for each input file specified. 
The input buffer address is contained in the DTF at 
postopen time. 


An output buffer is assigned for each output device 
specified. If the output buffer length is less than 144 
bytes, the buffer is located in the prime work area in 
ROCA. If the buffer length is greater than 144 bytes, 
a separate buffer area is allocated for the program. 
At postopen time, the address of the output buffer 
area is contained in the DTF. 


WORKSTN DTF extension: This area contains 
additional information, used by the RPG II program, 
about the work stations. The initiator and data 
management use this to get the address of the 
WORKSTN ID table. 


WORKSTN ID table: The WORKSTN ID table is an 
array of entries, describing the work stations 
associated with a program. An entry exists for each 
work station in a file. Within a given file, each work 
station entry is unique. The initiator and data 
management help maintain this table by setting the 
requester flag bit on for each entry, up to the 
MRTMAX value (number of display stations that can 
request a MRT program). 


RPG II halt processor transient ($$SYRP): This 
module is used when an error occurs during the 
execution of an RPG II user program. The module 
processes halts when requested by an RPG II 
compiler or RPG Il user program. It sets up a 
parameter list for SYSLOG 6 | and processes operator 
responses to the message. If a 0, 1, or 2 option is 
taken, $$SYRP returns to the RPG II program; if the 
operator cancels, $$SYRP passes control to the 
termination function 5 | 


Option O: Return to next instruction 

Option 1: Go to input mainline (unless otherwise 
stated) 

Option 2: Go to close mainline, close file, and go to 
end job 


SSP-ICF WORKSTN file: The RPG programmer uses a 
WORKSTN file as the interface to SSP-ICF data 
management i. For all WORKSTN file operations, 
work station data management Ei checks the ID field 
in the DTF. If the first character of the ID is numeric, 
the operation is routed to SSP-ICF data 

management i: otherwise, it is routed to work 
station data management 49 


Section 3: SSP to Language Program Product Interfaces 3-11 
This document contains restricted materials of IBM. LY21-0590-4 
©Copyright IBM Corp. 1983, 1984, 1985, 1986 


SSP TO BASIC INTERFACES 
BASIC Program Product Overview 


The BASIC Program Product operates in either edit 
mode or run mode. 


During edit mode, the BASIC program product takes 
user source staternents from the display station or a 
user library source member and converts the statement 
operators and operands into intermediate text. 
Intermediate text is the form in which BASIC source 
statements are stored on disk or in the main storage 
work area; the intermediate text provides a standardized 
notation scheme that allows faster compiler execution. 
During run mode, the compiler converts intermediate 
text into BASIC instruction set instructions. The 
instructions are executed by the BASIC instruction set 
emulator in control storage. Because the BASIC 
Program Product is interactive, it has many interfaces to 
SSP functions. 


Common BASIC Interfaces 


The following common interfaces are used by most 
BASIC functions and components: 


e Attn key processing by all BASIC modules accesses 
the TB and JCB. 


¢ Device |/O operations use open, allocate and 
deallocate EI. 


¢ File operations use open, allocate, and deallocate EI. 


e Library operations use open, allocate, and deallocate 
El librarian find and member find 6 | and control 
storage disk IOS. 


e Message operations use message retrieve Gi and 
sYs_oc 


« Print operations use message retrieve Gi for 
headings, control storage time and date retrieve for 
time and date information, and printer data 
management 4 | for printing. 


¢ For local data area access, the local data area |/O 
handler uses information retrieval 6 | to read, write, 
reread, or rewrite to the local data area. 


Special BASIC Interfaces 


The following BASIC components and functions use 
special interfaces to SSP: 


User Sign-On Commands 


At sign-on time, the SSP initiator processes the 
BASIC sign-on procedure commands. The commands 
and the initialization modules they evoke via the initiator 
are: 


BASIC Normal initialization (#BLINC) 

BASIC MRT MRT run mode initialization 
(#BLMIC) 

BASICP Procedure initialization (#BLPIC) 

BASICR Special run mode (#BLSIC) 

BASICS BASICS initialization (HBLSNC) 


The initialization modules use the following interfaces: 


¢ Control storage disk IOS to read and write from the 
work file 


e The XFER SVC instruction to transfer between 
modules ($XFER macroinstruction) 


« Information retrieval Gi to read the system local data 
area 


e Special allocate to allocate the work file 


¢« Work station data management 4 to determine 
system attributes and to open the work station file 


¢ Folder management services folder open g to open a 
data dictionary 
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Other BASIC Commands 


Other (non-initialization) BASIC commands and the 
system functions they evoke are: 


AUTO 


ALERT 


COLSEQ 


FREE 


HELP 


HISTORY 


LIBRARY 


DATADICT 


The display station module (#BLDSE), 
which handles the AUTO command, 
uses work station data management 
to display the line numbers on the 
screen 


The display station module (#BLDSE), 
which handles the ALERT command, 
uses work station data management 

to display the message on the screen 


The COLSEQO processor (#BLCSE) uses: 


¢« Work station data management 4 | to 
display the sequence 


« Control storage time and date to get 
the current time and date 


The FREE module (#BLFRE) uses: 


e Library member delete 6 | to delete 
the member 


e Special allocate and special deallocate 
to deallocate the file 


The HELP module (#BLHPE) uses: 


e Message retrieve Gg to get screen 
output 


e Work station data management | 4 to 
process prompts 


The command processor (#BLCPE), 
which handles the HISTORY command, 
uses history file put 8 to log the 
history file for the HISTORY command 


The LIBRARY module (#BLLDE) uses 
librarian find Gi to find the specified 
library 


The command processor (#BLCPE) 
which handles the DATADICT 
command uses FMS folder open | 4 to 
open a data dictionary 
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LIST 


LISTP 


LOAD 


MERGE 


PRINT 


The LIST module (#BLLIE) uses work 
station data management 4 | to list the 
work space 


The LISTP module (#BLLPE) and the 
XREF parameter processor (#BLXRE) 
use: 


¢ Special allocate and open to 
allocate and open the printer 


¢« Printer data management 4 | to print 
the lines 


e Close and deallocate to close 
the printer 


The LOAD module (#BLLDE) uses: 
« Source get G to load source or data 


¢ Control storage disk IOS to load a 
SUBR member 


e Librarian find and library member 
find [jl to find the library and 
member 


The MERGE processor (#BLMGE) uses: 


¢ Control storage disk IOS to read and 
write the work file for programs 


e Source get 6 | to get the records 
from the data source member 


The formatted print processor (#BLPFR) 
and the unformatted print processor 
(#BLUPR) use work station data 
management 4 | or printer data 
management 4 | to process print 
command requests to the work station 
or printer, respectively 


The library |/O processor (#BLDIR) 
uses control storage disk IOS to put 
the data in a work file 
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PROC 


RENUM 


SAVE or 
REPLACE 


STATUS 


SUBPROC 


The load module (#BLLDE), which 
handles the PROC command, uses: 


e Librarian find and library member 
find Fj to find the library and 
member, respectively 


¢« Source get Gi to load source 


The RENUM processor (#BLRNE) uses 
control storage disk IOS to read and 
write the work file 


The SAVE module (#BLSVE) uses 
librarian find and library member find 
to find the library and member, 

respectively 


The BASIC trace module (#BLRER) 
uses: 


e Message retrieve 6 | to get the 
headings 


¢ Control storage time and date to get 
get heading data 


e Allocate and open to open the 
printer 


¢ Printer data management 4 | to print 
the information 


¢« Close and deallocate to close 
the printer. 


The load module (#BLLDE), which 
handles the SUBROC command, uses: 


e Librarian find and library member 
find [J to find the library and 


member, respectively 


e Source get 6 | to load source 


BASIC Statements 


BASIC statements with external interfaces, and the 
modules they evoke are: 


BREAK 


CHAIN 


OPTION 
COLLATE 


PAUSE 


The trace module (#BLRER), which 

handles the BREAK statement, uses 
work station data management 4 | to 
display the character expression on 
the screen 


The chain module (#BLCHR) uses: 


e Librarian find and library member 
find [J to find the library and 
member, respectively 


¢« Source get 6 | to load source 


¢ Control storage disk IOS to load 
an SUBR member 


The run time module (#BLRUE), 
which handles the OPTION 
COLLATE statement, uses: 


e Librarian find and library member 
find [Ej to find the library and 
member, respectively 


« Source get 6 | to load source 


The trace module (#BLRER), which 

handles the PAUSE statement, uses 
work station data management Ei to 
display the character expression on 
the screen 
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RESTORE For input disk files, the open module Source Entry 
(#BLOPR) uses disk data 
management [§ For output disk files BASIC source entry takes place between the time the 
the open module (#BLOPR) uses BASIC or BASICP command was processed and the 
special close and special deallocate time the programmer enters the RUN command. The 
and special allocate and special BASIC edit-time display station manager 1 (#BLDSE) 
open [El to restore an output disk interfaces between SSP work station data management 
file. For library members the open 4 and the BASIC statement and command processors. 
module (#BLOPR) uses source 
get 

Special Run Mode 
TRACE The trace module (#BLRER) uses 


Intrinsic Functions 


message retrieve 6 | to retrieve 
messages, work station data 
management 4 | to put messages to 
the screen, special allocate and open 
to allocate and open the printer, 
and printer data management 4 to 
print the trace output. The trace 
module also uses control storage 
time and date retrieval in performing 
the requested trace 


Intrinsic functions and the interfaces they use are: 


At the beginning of special run mode, the initialization 
module (#BLSIC) uses librarian functions Gg to load the 
SUBR member containing the BASIC program. 


ATTRIBUTES Work station data management 4 

CURCOL and Work station data management 4 

CURROW 

DATE and Information retrieval Gg 

DATES 

MSG$ Librarian find, member find, and 
message retrieval 6 | 

TIME and Control storage time and date 

TIMES functions 

TIMER Work station data management Bor 
SSP-ICF data management 

UPSI$ Information Retrieval 6 

USERID$ JCB 

RETCODE$ Work station data management 4 or 


SSP-ICF data management 1.0 
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1/0 Interfaces 


e PUT/GET |/O Handlers: During the run-time 
execution of a BASIC program, the PUT |/O handler 
(#BLPSR) and the GET I/O handler (#BLGSR) use 
Disk data management 4. to write to or read from a 
stream file or unformatted disk file. 


e During the run-time execution of a BASIC program, 
the BASIC |/O handler (#BLIOR) uses disk data 
management to process disk read, write, delete, 
and restore requests. 


e The BASIC SSP-ICF module (#BLCMR) uses SSP-/ICF 
data management 1.0 to read from or write to a 
communications session. 


¢ The BASIC WAITIO module (#BLWAR) uses SSP-/CF 
data management 10 and work station data 
management ry to perform an accept operation. 


e The SFGR work station |/O module (#BLIOR) uses 
work station data management g to perform read, 
write, and rewrite operations to the display station. 


¢ BASIC Print: During the run-time execution of a 
BASIC program, the following print and input 
operations use SSP interfaces: 


Print to work station or printer: The formatted 
print processor (#BLPFR) and the unformatted 
print processor (#BLUPR) use work station data 
management 4 | or printer data management 4 to 
process print requests to the work station or 
printer. 


Print to library members: The library member |/O 
processor (#BLDIR) uses control storage disk IOS 
Full screen processor: The full screen processor 
module (#BLFSR) uses work station data 
management to process PRINT FIELDS and 
INPUT FIELDS statements. 


INPUT /LINPUT from work station: The 
INPUT/LINPUT 1/O handler (#BLIPR) uses work 
station data management to perform 
INPUT/PRINT operations. 


INPUT /LINPUT from library members: The library 
member |/O module (#BLDIR) uses source library 
get [dj to read from library members. 


BASIC Procedures 


In running BASIC procedures, the load source module 
(#BLLSE) uses source get 6 | to get the next line from 
the applicable procedure. 


BASIC Commands Processor 


In processing BASIC commands, the BASIC command 
processor module (#BLCPE) uses history file put 8 to 
log to the history file, control storage disk |OS to 
read/write the work file and termination to process 
the OFF command. 


BASIC Compiler 


The compiler (#BLICR) uses control storage disk IOS, 
special deallocate and work station data 
management Ei. 


BASIC Run-Time Monitor 


The run-time monitor (#BLRUE) uses control storage 
disk IOS, work station data management 4 | and librarian 
find 
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Open 


The BASIC OPEN module (#BLOPR) uses the following 
SSP interfaces: 


¢« For a disk file: 
— Special allocate and special open to allocate and 
open the file 
— Active format-1 area access G to scan fields in 
the format 1 


¢ For an input library member: Library find, single name 
find, and source get i, to set up the source get 
parameter list 


¢ For an output library member: library find, single 
name find, member protect 6 | and special disk allocate 
to allocate the scratch file 


The BASIC OPEN module (#BLPOR) uses special allocate 
and special open to allocate and open the printer file 


The BASIC OPEN module (#BLWOR) uses the following 
SSP interfaces: 


« For a work station file: 
— Library find 6 | to find the SFGR library 
— Single name find 6 | to find the SFGR load member 
— Work station data management g to open the 
work station file 


¢ For an SSP-ICF file: Special acquire I to open the 
communications file 


Close 


The BASIC close module (#BLCLR) uses the following 
SSP interfaces: 


¢« For a disk file: 
— Special deallocate and special close to 
deallocate/close the file 
— If close is requested for a stream file, disk data 
management g to write the last record. 


¢« For a printer file: 
— Printer data management 4 | to print the last record 
— Special deallocate and special close to close the 
printer file. 


¢« For a work station file: Work station data management 
4 | to close the file 


» For an SSP-ICF file: SSP-ICF data management [JJ to 
end the SSP-ICF session 


¢« For an input library member: If FREE is specified in 
the close request, library member delete 


¢« For an output library member: 

— Source get to read recoras, if writing to the end of 
an old member 

— Source put to write records to the member 

— Special deallocate to deallocate the scratch file 

— Control storage time-of-day to set the directory 
entry 

— l|f FREE is specified in the close request, Library 
find and Library member delete 


¢« For output to a new member (or if BEGIN was 
specified and no records were written): Library 
member protect 6 | 


Termination 


The BASIC termination module (#BLXTR) and special 
run mode termination (#BLSXR), use control storage disk 
IOS to read/write the work file, and deallocate and close 
to close the trace print file. The special run mode 
termination module (#BLSXR) also uses SYSLOG [MJ and 
termination to perform error message handling and 
end of job for the BASIC program. 
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SSP TO COBOL INTERFACES 
Compile-Time Interfaces 


The COBOL compiler uses the following interfaces to 
SSP and system functions: 


¢« Compiler Information Block (CIB): The CIB is a 
system block created by the initiator when a 
compilation is requested. The compiler extracts the 
modification reference number, date, and time from 
the CIB for the compiler prologue. The compiler also 
places information into the CIB (the current system 
date and time, the library submember type, the 
compiler work file extents, and the region size 
available) for later processing by the overlay linkage 
editor. 


e Extendable compiler work files: When the value that 
the user specified for allocating the compiler work 
files becomes too small, the compiler attempts to 
extend the work files automatically using the compiler 
access method (CAM) macroinstruction. If it extends 
the work files successfully, the new compiler work 
file extents are placed in the CIB. 


e Diagnosed source member: When the user requests a 
diagnosed source member, another compiler work file 
is allocated to contain this member. At the end of 
the compilation, this work file is passed to SEU (for 
the COBOLONL procedure) or to the /ibrary 
maintenance utility 8 | (for other compilation 
procedures) for replacement of the original source 
member. 


e Work file [OBs: CAM uses the IOB as input to control 
storage disk IOS, which physically reads/writes the 
files. The compiler accesses the $SOURCE and the 
$WORK files via CAM, which updates the IOB and 
calls control storage disk IOS. 


e Where-to-go table: One COBOL compiler module 
(#CBOO) contains a where-to-go table, which 
contains an entry for each of the compiler phases to 
be executed. The compiler routine (in #CBOO) that 
calls the next phase uses the where-to-go table 
entry as the loader parameter list. This table is 
updated automatically by the cross-reference resolver 

whenever library maintenance takes place in 
#COBLIB. 


System local data area (LDA): The system LDA is 
used to pass the parameters from the compiler 
procedures to the compiler. The compiler 
reads/writes this area using information retrieval Ej. 


Execution-Time Interfaces 


COBOL object programs use the following interfaces to 
SSP and system functions: 


Define the file (DTF): The DTF is the primary external 
interface to data management. Every user-defined file 
in a program creates an associated DTF. The COBOL 
compiler also creates a pre-DTF that is located in 
front of each DTF. The generated program maintains 
data in the pre-DTF, which contains information 
essential to the proper execution of the file. All file 
input/output operations in the COBOL-generated user 
program operate through standard interfaces with 
disk data management 4 | printer data 

management {§, work station data management 4 i 
and SSP-ICF data management [J 


SSP-ICF transaction files: Multiple transaction files 
can be defined for a COBOL program. A single 
transaction file can be repeatedly opened and closed, 
but no more than one transaction file may be opened 
at a time. 


The COBOL program uses the transaction (work 
station) files as the interface to SSP-ICF data 
management 1 OF For all transaction file operations, 
work station management 4 checks the ID field in 
the DTF. If the first character of the ID is numeric, the 
operation is routed to SSP-ICF data management 
otherwise, it is routed to work station data 
management 


Execution-time halts: For input/output operations to 
user-defined files, the user must provide error 
handlers for exceptional conditions. If no appropriate 
error handler is specified for a given file or operation 
and an exception occurs, the COBOL-generated 
program issues a halt. The COBOL display error 
message routine sets up a parameter list for 

SYSLOG Pl and processes operator responses to the 
error message. The operator can end the program or 
return to the program at the next logical statement. If 
the operator ends the program, the routine passes 
control to the termination function Ei. 
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SSP TO FORTRAN INTERFACES 


The FORTRAN Program Product consists of three parts: 
a compiler, an execution-time library, and the scientific 
interpreter. The compiler creates an object program 
which the overlay linkage editor (OLE) combines with the 
library routines to create an executable load module. 

The scientific interpreter is a control storage module that 
emulates the scientific instruction set. 


Compile-Time Interfaces 


The FORTRAN compiler uses the following interfaces to 
SSP and system functions: 


« $SOURCE file: The FORTRAN compiler uses the 
compiler access method (CAM) macroinstruction to 
read the source program from the $SOURCE file. The 
initiator El copies the source member or the SYSIN 

data stream to this file. 


« Compiler information block (CIB): The CIB is a 
system block created by the initiator when a 
compilation is requested. The compiler gets the 
source reference number, modification time, and date 
from the CIB and prints them, using the $DTFP and 
$PUTP macroinstructions to interface with printer 
data management 4 | It saves the compile time and 
date in the CIB for use by OLE. 


¢« System local data area (LDA): The compiler also uses 
the system LDA for passing parameters that are not 
passed by the CIB from the procedure to the 
compiler. The $INFO macroinstruction is used. 


¢« Cross-reference resolver (OXRF): The compiler uses 
the cross-reference resolver 6 | to locate the next 
compiler phase. The useful information from the 
OXRF entries is moved into the non-overlayable 
portion of the root module. The next compiler phase 
is then loaded by the $LOAD macroinstruction. 


« $WORK file: After the FORTRAN compiler has 
generated scientific instructions for the FORTRAN 
source statements, it uses disk data management 4 
to write the object code to the $WORK file. This file 
is used by the overlay linkage editor to create the 
load and/or subroutine modules. 


« Define the file (DTF): The DTF is the primary external 
interface to data management. The compiler 
generates a DTF for each file and/or device used in 
the FORTRAN program. The $DTFP, $DTFW, and 
¢$DTFD macroinstructions are used to build skeleton 
DTFs (for printer, work station, and disk data 
managements 4 | respectively). The DTFs are written 
to the $WORK file. 


Execution-Time Interfaces 

When a // LOAD OCL statement is used on a 
FORTRAN-generated load module, the allocate function 
loads the FORTRAN microcode into control storage. 
The FORTRAN program communicates with the 
scientific interpreter through a communications area 
within the program. This area, called FINCOM, is 
defined by the DFIN macroinstruction. Normally, index 
register 1 points to this area during program execution. 
The FORTRAN program transfers control to the 
interpreter by executing an XFER instruction. (For more 
information on this instruction, refer to XFER Instruction 


in this section.) 


The library routines provide access to the following 
system functions: 


« Printer data management 4 | 

« Disk data management 4 | 

e« Work station data management 4 | 
- SYSIN 

- sysuist 

« Message retrieve Gi 

« Information retrieval Gi 


« Control storage time of day 
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SSP TO THE ASSEMBLER LANGUAGE AND THE 
MACRO PROCESSOR 


The macro processor reads the $SOURCE file and writes 
the source program into the $ASMINPT file, expanding 
all macroinstruction call statements. The assembler uses 
¢ASMINPT as the source file (GSOURCE if the macro 
processor was not invoked), $WORK2 as a work file, 
and writes the object records to $WORK. All files are 
extendable. 


SSP to Assembler 
The assembler uses: 
e« Disk data management 4 to read and write files 


« Disk data management 4 | (via the CAM 
macroinstruction) to read and write the $WORK2 file 
when creating the cross-reference listing 


e System find Gi to retrieve the assembler phases 
¢ Control storage loader to run the phases 


e Printer data management 4 | to create the program 
listing 


Parameters are passed from the ASM procedure to the 
assembler via the system local data area (LDA). The 
assembler reads the LDA using information retrieval Gi. 


The assembler gets the modification reference number, 
date, and time from the compiler information block 
(CIB), and it puts the date and time of assembly, the 
library member subtype, the work file extents, and the 
region size into the CIB using information retrieval Gi. 


The assembler calls SYSLOG Gg to issue any displayed 
messages. 


The compiler passes the generated object program to 
the overlay linkage editor in the $WORK file. 


For information on the the execution-time interface 
between SSP and a user-written assembler program, 
see the Programming With Assembler manual and the 
Interactive Communications Feature: Reference manual. 
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SSP to Macro Processor 


The macro processor uses disk data management 4 | to 
read and write files. 


The macro-processor phases are retrieved and run using 
$FIND and $LOAD macroinstructions. A system find 
and load is performed to make source get 6 | resident. 
Source get retrieves the macroinstruction definitions that 
are to be expanded into source. 


The macros can be stored in any library. This is referred 
to as the macro library. The macro processor locates 
the macro library via active format-1 area access 6 fl 
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SSP to the Utilities Program Products 


The following SSP to’ the Utilities Program Product 
interfaces are described: 


Execution Phase 


After the subroutine and load members are created, 
DFU begins the execution phase. DFU maintains an 
execution common area. This area contains constants, 


» DFU keyword translations, control block pointers, and 
subroutines used by all execution-time modules. 
« SEU 
DFU uses disk data management 4 | for record insertion, 
» WSU retrieval, and update. DFU uses the $DTFW and $WSIO 
macroinstructions to interface with work station data 
« SDA management 4 | 
lf a severe error is encountered or if the user cancels, 
SSP TO DFU DFU invokes SYSLOG [MM to issue an error message. 


DFU has two major phases: setup phase and execution 
phase. The user signs on DFU by entering the DFU 
command. If the DFU program does not exist, DFU 
goes through setup to allow the user to define his DFU 
program. 


Setup Phase 


During setup, DFU maintains a common area pointed to 
by index register 1. This area contains constants, 
keyword translations, work file pointers, display station 
DTFs, and several subroutines used by all setup 
modules. 


DFU retrieves the modification reference number from 
the library control block and increments it if the user 
requests the DFU specification source to be saved. 


DFU also invokes the screen format generator 8 | to 
convert the DFU execution format source to load 
member form. The load member has the same name as 
the DFU program. 


lf a severe error is encountered or if the user wishes to 
cancel, DFU invokes SYSLOG Gi to isSue an error 
message. 
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SSP TO SEU 


Most of the SSP interfaces with SEU occur during 
initialization and at end of job. SEU maintains a common 
area, which contains the work station DTF, where-to-go 
tables (maintained by OXREF), an |OB, SEU’s data 
management routines (which use disk IOS), and various 
other subroutines and data areas. 


Initialization 


The user enters the SEU command to sign on to SEU. 
SYSIN Gi is used to retrieve the control statement. SEU 
uses SYSLOG 6 | to issue messages. Keywords are 
retrieved from SEU’s message member by message 
retrieve 6 | 


SEU maps to the format index area and builds a table of 
user format names and lengths for future use. 


The library maintenance utility is used for finding 
libraries and library members and for protecting the 
member being edited. 


If a diagnosed source member is specified in the control 
statement, the diagnosed source file is allocated as a 
consecutive output file. Disk data management 4 is 
used to read the records from the file. 


Special allocate is used to build the work file used by 
SEU. Source get 6 | retrieves the statements from the 
member, and disk IOS (control storage) is used to put 
the statement into the work file. 


End of Job 


SEU reads the library control sector to get information in 
the library. The library member subtype and reference 
number are updated in the library directory using the 
library maintenance utility Ey. 


Special allocate is used to allocate a work library, 
which temporarily contains the new or updated member. 


Disk IOS (control storage) is used to get the statements 
out of the work library and library sector get /put 6 | is 
used to put the statements into the work library. Library 
sector get/put Gi is then used to update the user’s 
library from the work library. 
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SSP TO WSU 


WSU has two major phases: the generation phase and 
the execution phase. During the generation phase, the 
user’s WSU source program is read and three library 
members can be produced: 


e An executable R-module 
¢« A user procedure to execute the R-module 
e« Any necessary screen format members 


During the execution phase, the R-module is executed 
and any of the 24 WSU execution phases are linked to it 
as necessary. 


Generation Phases 


During WSU program generation, WSU uses the first 80 
bytes and the last 18 bytes of the system local data 
area for various internal considerations. The reference 
number, reference date, and reference time are placed in 
the library directory entries of the generated libary 
members. 


The system macroinstructions used, and the system 
functions evoked, during the generation phase are: 


Execution Phases 


All execution initialization functions are performed by 
code that is executed once and then overlaid. Except for 
a small number of services provided by resident WSU 
routines, post-initialization functions are performed by 
WSU transient routines. These routines are packaged in 
load modules (#WSX00-#WSX20) that are accessed by 
call/exit linkage subroutines, which handle module 
loading. 


Because WSU transients are not loaded at 
predetermined locations, entry point addresses must be 
resolved dynamically. Address contents for individual 
routines are in a table in front of the module to aid 
resolutions. 


The DTF (define the file) is the primary external interface 
to data management. One DTF is assigned for each 
logical disk file used in the WSU program. However, 
here is only one work station DTF and screen data 
buffer assigned for the entire WSU program, regardless 
of the number of user formats defined or the number of 
work stations supported. 


Nonresident data other than data file records and 
transients are kept in a work file. At initialization time, 
data blocks (messages and calculation specifications) are 
transferred from the object program to the work file and 
then retrieved as needed. 


The system macroinstructions used, and the system 
functions evoked, during the execution phase are: 


$ALOC Allocate 

$DTFD Disk data management g 
$DTFO/SOPEN Open 

$PUTP Printer data management EJ 
$DTFP Printer open 

$IOBD Control storage disk IOS 


SFIND/SFNDP 


System find 6 | 


$LOAD Control storage loader 
$TOD, Control storage 

$TRB timer 

$XFER Control storage transfer 
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$ALOC Allocate 

$CLOS Close 

$DTFO/$OPEN Open 

$DTFW/$WSEQ_ Work station data management Ej 


$FIND/SFNDP 


System find G 


SINFO Information retrieval 
$IOBD Control storage disk IOS 
$LOAD Control storage loader 
$LMSG/$LOG/ _sysLoc J 

$LOGD 

$TRB Control storage timer 
$XFER Control storage transfer 
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SSP TO SDA 

SDA consists of four major phases: initialization, 
selection, definition, and termination. 
Initialization 


The initialization phase uses the following SSP 
interfaces: 


e The system local data area (LDA), which is initialized 
to establish the user’s SDA profile. 


e Existence checking (special allocate function ED) on 
SDA work files to determine recovery potential. 

Selection 

The selection phase uses the following SSP interfaces: 

e Work station data management 4 | and the message 
retrieve Gi to support display screen presentation 


during selection. 


e The system LDA for retrieving and maintaining SDA 
profile information. 


¢« Source member retrieval (record mode source get 6B). 


¢« Work file allocation/initialization of primary file. 

¢ Load and execution of definition and termination 
phases. 

Definition 

The definition phase uses the following SSP interfaces: 

e Work station data management 4 and message 
retrieval Gi to support display presentations during 
the definition phase. 


¢ Primary work file |/O to save definition work. 


« Work file allocation /initialization/deletion of the 
secondary file. 
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Termination 


The termination phase uses the following SSP 
interfaces: 


e Work station data management 4 and message 
retrieval Gg to support display presentation for 
end-of-function option display screens. 


¢ Primary work file |/O and deletion. 


¢ Control storage time and date for directory and printer 
heading. 


¢ Source member output (record mode source put Bi). 
« Printer data management 4 | 
e System LDA access for linkages to compilers 


(invokes the screen format generator 8 i build menu 
6 | and WSU). 
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SSP to OFFICE/36 


OFFICE/36 includes Query/36, Personal Services/36 
(PS/36), DisplayWrite/36 (DW/36), and PC 

Support/36. Because of obvious PS/36 and DW/36 
interdependencies, the interface descriptions for PS/36 
and DW/36 are combined. As a convenience to the 
reader, the screen names associated with these 
PS/36-DW/36 user functions are listed under the names 
of the functions they invoke. Query/36 interfaces are 
described separately. 


SSP TO OFFICE/36 EXECUTABLE CODE 


SSP to Query/36 Interfaces 

Query/36 uses special allocate to allocate output disk 
files, overflow disk files, printers, and all disk files being 
queried. 

For all operations to display stations, Query/36 calls 
work station data management Kj via a transfer SVC 


instruction with a work station parameter list (WSPL). 


Query/36 uses query data management 4 to retrieve 
records from disk files being queried. 


Query/36 calls control storage disk IOS to do the 
following: 


e Read a library directory to build a list of queries in a 
library. 


¢« Read Query/36 members from a library. 
« Read the VTOC to build a list of libraries or files. 


¢« Read/write the overflow disk file, if necessary. 


Query/36 uses folder management services (FMS) 4 | 
for the following purposes: 


¢ To read file definition information from dictionaries 
including formats contained in file, format record ID 
codes, fields in formats, and field locations, types, 
and sizes. 


¢ To interface to the DW/36 editor for the purposes of 
putting output data, or the data field instructions that 
define the output fields, into a DW/36-created work 
document. 


¢ To interface to DW/36 print to put Query/36 output 
data into a special page in the DW/36 document. 


Query/36 uses VTOC access Gi to determine what, if 


any, file definition and dictionary a file's format 1 is 
linked to. 


Query/36 uses librarian functions [fj for the following 
purposes: 


¢ To find a library and a Query/36 member (SUBR) 
within the library, to make the library the new 
working library, and to free the old library. 


¢ To protect a Query/36 member. 


¢ To write a new Query/36 definition to a library, or 
update an existing Query/36 member in a library. 


Query/36 uses system evoke EA to build the default 
Query /36 library #QUERY. 


Query/36 uses query data management Eto retrieve 
records from the input file specified for a report. 


Query/36 interfaces to security support user profile 
services 8 to save information about a specific user ID. 
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SSP to PS/36 and DW/36 
As a convenience to the reader, the display names 


associated with the following functions are listed under 
the names of the functions they invoke. 


Maintain Mail Folder and Mail Control Flow 


The maintain mail folder function is invoked by the 
following displays: 


¢ OFCMNT 

¢ MAINTAIN MAIL FOLDER 

¢ MOVE DOCUMENT TO PRIVATE FOLDER 

e DELETE DOCUMENTS FROM MAIL FOLDER 
¢ CHANGE DOCUMENT COUNTERS 


The maintain mail folder function uses librarian functions 
Fl to find the DW/36 library and load member and to 
find the resource security module. 


The maintain mail folder function uses fo/der 
management services EG to open, close, copy, delete, 
update, search, and list the mail folder; and to open, 
close, and update the users’ folders. Also, the mail 
folder uses Resource Security to secure documents in 
the users’ text folder. 


The mail control flow function uses the following 
interfaces: 


¢ Special allocate to allocate disk and printer files. 


e Work station data management 4 | to read from/write 
to display stations. 


¢ Folder management services 4 | to access mail logs, 
access mail folders, and to access the DW/36 print 
function temporary folder. 


The maintain mail folder and mail control flow functions 


uses profiles transforms 4 | to convert documents from 
L2 or L3 to DW/36 format. 
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Document Library Services 


The document library services function is invoked by the 
OFCDLS display. 


The document library services function uses the 
following interfaces: 


¢ Librarian function — to find the DW/36 library and 
load members and to find the PC Support/36 library 
and load members. 

¢ Special allocate to allocate disk and printer files. 


¢ Disk data management to read from/write to disk 
files. 


¢ Work station data management 
to display stations. 


to read from/write 


¢ Folder management services to access (open, 
close, copy, delete, update, and search) the library 
services folder and to access (open, close, update, 
and search) users’ folders. 


e VTOC access (read) to determine file type. 


Maintain Communications Routes and Queue 
Definitions 

The maintain communications routes and queue 
definitions functions are invoked by the following 
displays: 

© OFCMNT 

© MAINTAIN COMMUNICATIONS ROUTES 

¢ ADD COMMUNICATIONS ROUTES 

¢ CHANGE COMMUNICATIONS ROUTES 


¢ DELETE COMMUNICATIONS ROUTES 


¢ MAINTAIN COMMUNICATIONS QUEUE DEFINITIONS 
¢ ADD COMMUNICATIONS QUEUE DEFINITIONS 

* CHANGE COMMUNICATIONS QUEUE DEFINITIONS 
¢ DELETE COMMUNICATIONS QUEUE DEFINITIONS 
The maintain communications routes and queue 


definitions functions use fo/der management services 
Q¥ to open and close the mail folder. 
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Administration Installation 


The administration installation function is invoked by the 
following displays: 


¢ SETUP OR MAINTAIN PS/36 FUNCTIONS 
e CREATE DIRECTORY FILES 

e CREATE GROUP FILE 

e CREATE CALENDAR INDEX FILE 

e CREATE ACTIVITY QUEUE FILE 

e CREATE MAIL FOLDER 

e CREATE MAIL INFORMATION FILE 
e CREATE ACKNOWLEDGMENT FILE 
e CREATE MAIL QUEUE FILE 

e CREATE PROFILE FILE 

e CREATE STORAGE FOLDER 

e MAINTAIN PS/36 DEFAULTS 


The administration installation function uses the 
following interfaces: 


¢ Special allocate to allocate all disk files it creates. 
« DDM to read and write to disk files. 


« VTOC access (read/write) to determine if a file's 
format is on the system. 


e Work station data management 4 to read from/write 
to display stations. 


¢« Folder management services 4 | to create or perform 
existence checks on the mail folder and the safe 
folder. 


¢ Resource security file and edit 8 to secure PS/36 
files and folders. 


Enrollment 


The enrollment function is invoked by the following 
displays: 


SELF ENROLLMENT 
¢ ENROLL NEW PS/36 USER 
¢ USER DEFAULTS 


¢ ENROLL NEW INDEPENDENT WORK STATION 
USERS 


¢ ENROLLMENT INFORMATION 

¢ CHANGE ENROLLMENT FOR PS/36 USERS 

¢ CHANGE ENROLLMENT FOR IWS USERS 

¢ DELETE FROM PS/36 

¢ DELETE ENROLLMENT 

The enrollment function uses the following interfaces: 


¢ Special allocate Kj to allocate all disk files it creates or 
uses. 


¢ Disk data management to read from/write to disk 4 | 
files. 


¢« Work station data management 4 | to read from/write 
to display stations. 


e Folder management services 4 | to open, close, or 
delete mail folders, and to create, open, delete, read, 
or update mail logs. 


e Resource security file and edit 8 to secure mail logs 


and check authorization for access to files and the 
mail log. 
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Group Control 


The group control function is invoked by the following , 
displays: 


« USE PERSONAL SERVICES /36 
« WORK WITH GROUPS 
The group control function uses the following interfaces: 


¢ Special allocate J to allocate all disk files it creates 
or uses. 


e Disk data management to read from/write to disk 
files. 


« Work station data management 4 | to read from/write 
to display stations. 


e Resource security 8 to check authorization for 
access to files. 


SSP TO OFFICE/36 DATA AREAS 


Query/36 Data Areas 


During its report function initialization, Query/36 
retrieves QRYRUN procedure parameters from the 
procedure parameter save area (PPSA). Information 
from the PPSA is used to build the Query/36 parameter 
list, which tells query data management what record 
selection tests to perform, what fields to select for 
Query/36 output, and what calculations and/or sorting 
to perform. 


All Query/36 work areas are allocated in query TWS 
(task work space). When a module needs to access a 
data area contained in TWS, the module maps to the 
needed information. Initially, Query/36 is allocated 180K 
bytes of TWS; the following table shows the general 
allocation of the query TWS: 


Query/36 receives up to 222K of TWS for a field table. 
Only the amount needed is obtained. 
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The Query/36 data management work area is also on 
TWS. Query/36 receives 60K of TWS for each file, up to 
a maximum of 300K. 

SSP TO DEVELOPMENT SUPPORT UTILITY 

The Development Support Utility (DSU) is a program 
product used to create, edit, remove, view, or print 
source members and procedure members. DSU has a 
full screen editor that allows editing for an entire screen 
of data at atime. The product also provides a wide 
range of line commands, RPG syntax checking, prompts, 
and format lines to help enter and change language and 
utility statements. 

DSU uses Session Init to: 

« Perform SYSIN. 

« Perform SYSLOG. 

¢ Open a session. 

DSU uses the List functions to: 

¢ Obtain a list of members. 

e Delete a member. 

e Read member records for the view or print option. 
DSU uses the Edit Init Library Access Method to: 

« Protect the edit member. 

¢ Load the member into the file. 

¢« Read the user profile. 

DSU uses the Edit function to: 

e Handle disk data management. 


DSU uses the Exit processing Library Access Method to: 


¢« Protect and find a new member name if specified at 
end of job. 


e Save a member. 


¢ Protect the edit member or new member specified at 
end of job. 


¢ Delete the workfile using special allocate. 
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PS/36 and DW/36 Data Areas 


Mail Log 


A mail log is a folder management services folder that is 
created with only the data descriptor area (DDA) of the 
folder; the mail log entries reside in the DDA. 


Mail Folder 


The mail folder is a normal folder management services 
folder that contains a special DDA record for each 
document. This record is a count of the number of mail 
log entries and DIA queue entries referring to the 
document and Is called the associate record. 


PS/36 and DW/36 Storage 


OFFICE/36 uses a flexible storage management scheme 
that allows it to partition its 48K-byte region into 
separate areas for program code and data. The 
following storage map shows the general layout of 
PS/36 and DW/36 storage: 


Variable 


Caller parameter control block (optional) 


Storage in the dynamic storage stack is allocated in 
8-byte multiples. Storage is allocated and freed as a 
LIFO stack. Executing programs are responsible for 
sequencing their data area storage request in order by 
degree of permanence. 
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This directory serves as a reference to the control flow 


charts in this manual and to the microfiche listings. The 
entries under Chart Number directly refer to control flow 


charts in Section 2, and the labels under Entry Point 
(listed for modules with multiple-entry points) can be 
used in the cross-reference portion of the microfiche 
listings. Modules are listed in alphabetic order by 
module name. 


Each directory entry contains the module name, control 
flow chart references (if any), the module entry point(s), 
the descriptive name, and a brief description of the 
module’s function. 


ADDITIONAL MODULE INFORMATION 


For additional information on module detail attributes, 
sizes, and link addresses, enter the following OCL 
statements: 


// LOAD $MAINT 

// RUN 

// COPY FROM-#LIBRARY,NAME-DIR,LIBRARY-O, 
// TO-PRINT, LIST-DETAIL, PAGE-NO 

// END 


To decode the attribute bytes given in the $MAINT 
listing, refer to Library Directory, Macro DIREQ in the 
System Data Areas manual. 
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Section 4: Directory 


MODULE STORAGE LOCATION 


For the purposes of locating modules in storage, SSP 
modules can be classified according to three types: 


« Real transients must execute in the system transient 
area. The word transient is included in the descriptive 
names of all real transients. 


Note: SSP-ICF subsystems use a transient area 
defined by SSP-ICF control that is in no way 
associated with the system transient area. In text, 
this transient area is always referred to as the 
SSP-ICF transient area. 


e Resident modules are loaded according to 
configuration options specified, or otherwise in effect, 
at IPL time. The word resident is included in the 
descriptive names of all resident modules. 


e Logical transients (also called translated transients) 
execute as transients, but the supervisor can load 
them in any available storage, real or translated. 


DIRECTORY CHART REFERENCES 


Many module entries have more than one chart 
reference. The chart references for each module are 
listed according to the relative amount of information 
they contain. Therefore, the first chart reference should 
provide you with the most information on the subject 
module’s control flow. 


Note: Overview charts (those that have chart numbers 
ending with .0) are not referenced, except when the 
overview chart is the only reference for a module. If you 
need more control flow information than you find in the 
referenced chart(s), you should determine whether 
Section 2 contains an overview chart for the module 
reference. (For example, if the first chart referenced is 
Chart 9.2.3, you should look for a chart numbered 9.2.0 
or 9.0.) For more information on the organization of 
control flow information in this manual, refer to Chart 
Numbering in Section 2. 
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Module Chart 
Name Number Entry Point Descriptive Name Function 
$ARSP 8.1 $ARSP Autoresponse utility Place autoresponse severity values and 
alert indicators into a message load 
member. 
$BICDI 8.2.1 $BICDI Basic exchange file display Display a basic exchange diskette file on 
the SYSLIST device. 
$BICET 8.2.2 $BICET l-exchange diskette-to-disk Copy (or add) records from an 
l-exchange diskette to a disk file. 
$BICFI 8.2.3 $BICFI Basic exchange disk to diskette Copy (or add) records from a disk file to 
a basic exchange diskette file. 
$BICIF 8.2.2 $BICIF Basic exchange diskette to disk Copy (or add) records from a basic 
exchange diskette file to a disk file. 
$BICR 8.2.0 $BICR Basic or |-exchange mainline Control the copying or displaying of 
records from a diskette basic or 
l-exchange file. 
$BICST 8.2.1 $BICST l-exchange file display Display an l-exchange diskette file on 
the SYSLIST device. 
$BICTE 8.2.3 $BICTE l-exchange disk to diskette Copy (or add) records from a disk file to 
an l-exchange diskette file. 
$BMENU 8.3 $BMENU Build Menu utility Build SFGR load module from a source 
menu. 
$BUILD 8.4 $BUILD Sector rebuild utility Prompt for and correct bad disk sectors. 
$CNAD — $CNAD1 Configuration utility: add Set configuration record update flags 
support based on values set in system local data 
area. 
$CNAD 1 1232 $CNAD1 Configuration utility: install Set current, add, drop, and release 
program product support update flags in configuration record. 
$CNAD2 1.2.2 $CNAD2 Configuration utility: install Prompt for and set flags in configuration 
SSP features and optional member for changes to SSP features 
SSP support and optional SSP. 
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Module Chart 


Name Number Entry Point Descriptive Name Function 
SCNAID 1.2.1 AIDBEG System configuration support Provide the following capabilities: 
1.2.2 aids 


e Condense or extend a specified 
library 


e Get the size of user available area 
and #LIBRARY. 


e Calculate number of diskettes 
required to back up specified library. 


e Calculate number of diskettes 
needed to save a library. 


$CNAMO 1.2.4.1 CNAMBEG Configuration for display station Provide for updating of device 
on remote controller configuration for 5294 Remote Control 
Unit. 
$CNDED — $CNDED System configuration dedicated Establish dedicated interface for system 
interface configuration. 
$CNDP 1.2.4 DBEG System configuration default Prompt for and set default printers for 
printer assign each display station on the system. 
$CNDRP 1.2.5 $CNDRP1 Configuration utility: drop Set configuration record update flags 
support based on values set in the system local 
data area. 
$CNDWS 1.2.4.1 $CNDWSO System configuration utility: Set default logical IDs, controller |Ds and 


work station default assignment addresses, and unit addresses for local 
and remote work stations. 


SCNFIG 1.2.1 System configuration utility: Set IPL defaults. 
1.2.5 root phase 

$CNF1 1.2.1 $CNF1 System configuration utility: Prompt for and set IPL defaults. 
main menu 

SCNHLP 1.2.1 System configuration help utility Set up help text menu. 

S$CNMAT 1.2.4 $CNMAT Configuration utility: modify Prompt for and set attributes assigned to 
work station attributes a work station. 

$CNMID 1.2.4 $CNMID System configuration utility: Perform for and set work station logical 


modify work station logical IDs. IDs, subconsole assignment, and default 
printer assignment. 
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Module 
Name 


$CNMSR 


$CNMUP 


$CNNAP 


$CNPLN 


$CNPRT 


$CNREM 


$CNRLD 


$CNRWS 


$CNSA 


$CNSET 


$CNSKP 


$CNSTK 


$CNSYP 


Chart 
Number 


1.2.2 


1.2.1 


1.2.1 


1.2.1 


1.2.4.1 


1.2.2 


1.2.3 


1.2.4.1 


1.2.2 


1.2.4.1 


1.2.4 


1.2.1 


lee 


1.2.1 


1.2.4 


Entry Point 
$CNMSR 


$CNUPT 


CNMUPBEG 


NAPBEG 


$CNPLN1 


$CNPRT 


CNRMBEG 


$CNRLD 


RWSBEG 


SABEG 


SETENTRY 


SKPENTRY 


STKENTRY 


SYSBEG 


Descriptive Name 


System configuration utility: 
create, edit, or delete utility 


System configuration update 
rebuild 


Update master configuration 
record 


System configuration of 3262 
Printer 


System configuration: planning 
information 


CNFIGSSP print function 


Configuration for display station 
on remote controller 


System configuration utility: 
modify work station attributes 


Set remote line attributes 


System configuration 
subconsole assign 


Configuration: update LDA 


Configuration: update LDA 


Configuration: update LDA 


System configuration system 
printer assign 


Function 


Prompt for the creating, editing, or 
deleting of a configuration member. 


Alter master configuration member. 
Prompt for and make changes to master 
configuration record. 


Prompt for 3262 Printer configuration. 


Present planning information display. 


Display configuration print menu and 
route for options selected. 


Provide for updating of device 
configuration for 3274 Remote Control 
Unit. 


Prompt for and set work station 
attributes. 


Set the following attributes: 
e Switch type. 

¢ Auto-reconnect. 

e Modem speed. 

e DDS adapter attached. 
e EIA interface. 


Prompt for and set assignment of a 
subconsole for each printer on the system. 


Set flags in LDA based on changes to be 
made in configuration record. 


Set flags in LDA based on changes to be 
made in configuration record. Used for 
Kanji systems. 


Set flags in LDA based on changes to be 
made in configuration record. Used for 
Kanji-preferred systems. 


Prompt for and set assignment of 
system printer. 
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Module Chart 
Name Number Entry Point Descriptive Name Function 
$S$CNSYS 1.2.2 $CNSYS Configuration utility: system Prompt for and set system, print, and 
parameters spooling features. 
SCNTRT 1.2.2 CNTRT Configuration: select 3270 Select user-specified translate tables to 
device emulation translate tables be used by BSC or SNA 3270, 3278, 
and 3279 device emulation. 
$CNWD 1.2.4.1 CNWDBEG System configuration work Define controllers and specify number of 
station add, delete, or modify devices on each controller port. 
remote controllers 
S$CNWD2 1.2.4.1 CNWD2BEG _ Error processing for $CNWD Check for controller errors. Update error 
flags. 
$CNWD3 1.2.4. 1 CNWD3BEG _ System configuration work Handle the OFF DROP prompt for 
station add, delete, or modify SCNWD. 
remote controllers 
SCNWN 1.2.4.1 CNWNBEG System configuration work Prompt for and set additions, deletions, 
station add, delete, or modify and modifications to configuration data 
local or remote work stations for local and remote devices. 
and printers 
$CNWO 1.2.4 $CNWO1 System configuration utility: Display option menu for editing work 
1.2.4.1 work station menu Station portion of configuration member. 
SCNWP 1.2.4 CNWPOO System configuration utility: Provide the interface to the displayed 
generalized work station select screen for $CNSA. 
routine 
$COADD 8.5.2 $COADD High-speed add of disk Add a disk file to an existing diskette 
file to diskette file file. 
$COCRT 8.2.1 $COCRT Display to the CRT Interface between $COGET, $CORMT, 
8.5.1 or $TCTSL and work station data 
8.31.1 management. 
$COGET 8.5.1.3 $COGET Get/put interface with Interface for record mode data 
record-mode data management and/or $COCRT and 
management SCOPRT. 
$SCOINT 8.5.1.1 $SCOINT Record mode/remote file Initialize files to be copied in record 
8.5.1.2 copy input initialization mode. Disk file may be local or remote. 
$COOUT 8.5.1.2 $COOUT Record mode/remote file Prepare for output to disk, 
8.5.1.3 copy output initialization diskette, or display. Disk file may be 
8.5.1.4 local or remote. 
$COPRT 8.2.1 $COPRT Display to the printer Interface between $COGET, $CORMT, 
8.5.1 or $TCTSL and printer data 
8.31.1 management. 
$SCOPY 8.5.0 $COPY Copy user file(s) utility Mainline module of the $COPY utility. 
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Invoke the syntax checker and route 
control to $COINT, $COADD, $COZFF, 
$COZRS, or $COZSV according to the 
function specified. 
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Module Chart 
Name Number _ Entry Point Descriptive Name Function 
$CORMT 8.5.1.4 $CORMT Remote file copy through Get/put interface with both record 
direct interface with mode data management and 
distributed data management distributed data management. 
$COZFF 8.5.3 $COZFF Interface with sector mode Control for disk-to-disk copy. 
data management for 
disk-to-disk copy 
$COZRS 8.5.4 $COZRS Interface with sector mode Control for diskette-to-disk 
data management for RESTORE operation. 
diskette-to-disk RESTORE 
operation 
$COZSV 8.5.5 $COZSV Interface with sector mode Control for disk-to-diskette SAVE 
data management for operation. 
disk-to-diskette SAVE 
operation 
$CPMG — $CPMG MSGFILE procedure Display/update status of system 
message file. 
$SCPPE 8.6 $CPPE Procedure interface to SYSLOG Issue error message. 
$CZUT 10.9.2.2 $CZUT Alert utility Change alert generation indicators in 
specified alertable messages. 
$DACHK 7.1.8 DACHK Diskette drive check Perform track O read, worn head test, 
and alignment test. 
$DALOG 7.1.8 $DALOG Display diskette log Display diskette log and allow operator 
update. 
$DAMP 7.1.8 DAMP Diskette utilities supervisor Allocate the diskette drive, prompt for 
option selection, load and call program 
for option selected, and clean up after 
specified utility terminates. 
$DARCV 7.1.8 $DARCV Diskette sector recovery Perform multiple reads on specified 
sector, Saving any successful read data 
and informing user of error read. 
Multiple write back, with verification. 
$DASCN 7.1.8 DASCN Scan diskette for errors Read verify all sectors on the diskette 
and print a summary report. 
$DCOPY 8.37 DCOPY Diagnostic diskette copy Copy an entire diskette, regardless 
utility of content; sectors 3, 5, and 6 and 
cylinder O head O are not copied. 
$DDST 8.7 $DDST Key sort utility Sort the keys of a specified file. 
$DELET 8.8 $DELET File/Library delete control Read input parameters, determine which 
module function is to be performed, and load the 
proper module. 
$DELF1 8.8 $DELF1 Delete files from fixed disk Delete files from fixed disk. 
$DELI1 8.8 $DELI1 Delete files from diskette Delete files from diskette. 
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Module 


Name 


$DSBO 


$DUPFX 


$DUPRD 


$DUPIA 


$DUPOA 


$DUP1F 


$DUP2F 


$ERAP 


SERA2 


$ERA3 


$ERCE 


$ERD2 


$ERD3 


Chart 


Number 


8.36.7 


8.9 


8.9 


8.9 


8.9 


8.9 


8.9 


7.1.1 


7.1.1 


Entry Point 


$DSBO 


$DUPFX 


$DUPRD 


$DUPIA 


$DUPOA 


$DUP1F 


$DUP2F 


SERAP 


DEVFMT 


DEVFMT 


DEVFMT 


DEVFMT 


DEVFMT 


Descriptive Name 


IDDU common open 

Diskette copy utility sector fix 
transient 

Diskette copy utility mainline 
Diskette all file input copy 
Diskette all file output copy 
Diskette single file input copy 
Diskette single file output copy 
Error recording analysis 


procedure mainline 


ERAP 21ED disk drive error 
formatter 


ERAP 10SR disk drive error 
formatter 


ERAP local display station and 
printer error formatter 


ERAP diskette drive error 
formatter 


ERAP diskette magazine drive 
error formatter 
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Function 


Opens data dictionaries and file 
definitions within them. 


Process diskette read errors detected by 
diskette copy utility modules. 


Perform mainline processing for diskette 
single-file or all-file copying. 


Copy all files from diskette to scratch 
disk files. 


Copy files from scratch disk files to 
diskette. 


Copy specified file from diskette to 
common area. 


Copy specified file from common area to 
diskette. 


Format and display or print error history 
information for all system devices. 


Put formatted 21ED disk drive SIO 
counts, error counts, and error history 
table information to requester display 
station or requested printer. 


Put formatted 10SR disk drive SIO 
counts, error counts, and error history 
table information to requester display 
station or requested printer. If 
requested, reset SIO and error counts. 


Put formatted local display station and 
printer SIO counts, error counts, and 
error history table information to 
requester display station or requested 
printer. If requested, reset SIO and 
error counts. 


Put formatted diskette drive SIO counts, 
error counts, and error history table 
information to requester display station 
or requested printer. If requested, reset 
SIO and error counts. 


Put formatted diskette magazine drive 
SIO counts, error counts, and error 
history table information to requester 
display station or requested printer. 

If requested, reset SIO and error counts. 
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Module 
Name 


Chart 


Number Entry Point Descriptive Name Function 


$ERE2 ye a DEVFMT 


SERSM 


$ERO2 


$ERO3 


$ER6C 


$ER68 


$ER8A 


$ER8E 


$ER80 


$ER81 


$ER82 


$ER83 
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7.1.1 


7.1.1 


7.1.1 


7.1.1 


7.1.1 


7.1.1 


7.1.1 


7.1.1 


7.1.1 


7.1.1 


AA 


DEVFMT 


DEVFMT 


DEVFMT 


DEVFMT 


DEVFMT 


DEVFMT 


DEVFMT 


DEVFMT 


DEVFMT 


DEVFMT 


DEVFMT 


ERAP line printer error formatter Put formatted line printer SIO counts, 


ERAP summary formatter 


ERAP control processor error 
formatter 


ERAP main storage processor 
error formatter 


ERAP local attachment 
(controller) formatter 


ERAP MLCA/ELCA error 
formatter 
ERAP remote work stations 


controllers error formatter 


ERAP remote display stations 


and printers error formatter 


ERAP BSC formatter 


ERAP SDLC formatter 


ERAP autocall formatter 


ERAP X.21 formatter 


error counts, and error history table 
information to requester display station 
or requested printer. 

If requested, reset SIO and error counts. 


Put formatted ERAP summary data to 
requester display station or requested 
printer. 


Put formatted control storage processor 
error history table information to 
requester display station or requested 
printer. 


Put formatted main storage processor 
error history table information requester 
display station or requested printer. 


Put formatted attachment SIO counts, 
error counts, and error history table 
information to requester display station 
or requested printer. 


Put formatted MLCA/ELCA error 
history table information to requester 
display station or requested printer. 


Put formatted remote work station 
controllers error history table information 
to requester display station or requested 
printer. 


Put formatted remote display station and 
printer error history table information to 
requester display station or requested 
printer. 


Put formatted BSC SIO counts, error 
counts, and error history table 
information to requester display station 
or requested printer. 


Put formatted SDLC SIO counts, error 
counts, and error history table 
information to requester display station 
or requested printer. 


Put formatted autocall SIO counts, error 
counts, and error history table 
information to requester display station 
or requested printer. 


Put formatted X.21 SIO counts, error 
counts, and error history table 
information to requester display station 
or requested printer. 
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Module 
Name 


$FBAIB 


SFBLD 


$FEACD 


$FEAIDS 


$FEALK 


Chart 
Number 


4.11.10 
4.11.11 
8.5.4 
8.10 


8.10 


7.1.6 


7.1.0 


7.1.5 


Entry Point Descriptive Name 


$FBAIB Alternative index build 


$FBLD File build utility 


FEACD Diagnostic aids setdump or 


address compare dump 


FESTARTZ Diagnostic aids mainline 


ABORT 
BINTODEC 
BINTOHEX 
DECTOBIN 
HEXTOBIN 
DISKIO 
ENDIT 
ERROR 


FETCH 


FORMAT 


FINDMIC 


GENIO 


MOVEIT 
OVERLAY 
PRINT 
RETURN 
SAVREGS 
WSIO 


$FEALK Diagnostic aids APAR utility 2 
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Function 


Build an alternative index file from an 
existing physical file. 


Create a null disk or control the building 
of an alternative index file. 


Provide for user determined limits for 
debug-type dumps. 


Initialize for diagnostic aids utilities and 
provide common subroutines: 


Abnormally terminates a utility. 

Converts binary to zone decimal. 
Converts binary to printable hexadecimal. 
Converts zone decimal to binary. 
Converts printable hexadecimal to binary. 
Processes disk |/O requests. 

Terminates a utility. 

Processes halts or SYSLOG calls. 


Loads and passes control to a diagnostic 
aids utility. 


Formatting message/data merge 
function. 


Retrieves a message. 


Interfaces between utility and printer or 
work station. 


Moves blocks of data. 

Loads and calls overlay modules. 
Processes print requests. 

Returns to caller in push stack. 
Saves caller's registers in push stack. 
Processes work station |/O requests. 


Copy data needed to diagnose a 
software problem from disk to diskette. 


Section 4: Directory 4-9 


Module Chart 
Name Number 


$FEAPR 7.1.5 


$FEBTR 7.1.4 


$FECHK 7.2 


SFECNT 7.1.0 


SFECNV 7.1.1 


4-10 


Entry Point 


$FEAPR 


$FEBTR 


$FECHK 


FECNT 


FECNV 


TUTOD 
TODTU 
MULTIPLY 


DIVIDE 


Descriptive Name 


Diagnostic aids APAR utility 1 


Diagnostic aids batch trace 
utility 


PTF prerequisite checking 


Diagnostic aids router 


Diagnostic aids conversion 
routines 
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Function 


Create the following APAR files on 
diskette by copying data from disk: 


e APARFILE (task or stand-alone 
dump). 


e CONTFILE (control storage). 
e lOCFILE (I/O controller). 
e TRCEFILE (trace header file). 


e [name ]FILE (trace file with 
user-specified name). 


e PTFFILE (#PTFLOGS for program 
products). 


e SYSFILE (configuration record, 
VTOC, trace work area and diskette 
work area). 

e MCDEFILE (microcode tables). 

¢ HISTFILE (history file). 

e SERVFILE (service log). 

e SPOLFILE (spool file). 

e JOBQFILE (input job queue file). 

e ERAPFILE (error logging tables). 

e CKPTFILE (checkpoint restart file). 


Create or modify batch environment 
trace tables. 


Process a PTF file to determine if all 
prerequisites are present. 


Read utility control statements, set up 
any required diskette processing, and 
load and pass control to requested 
function. 


Provide conversion routines for use by 
diagnostic aids programs: 


Convert timer units to time of day. 
Convert time of day to timer units. 
Multiply two numbers. 


Divide two numbers. 
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Module Chart 


Name Number Entry Point Descriptive Name Function 
$FECON 7.1.2.8 FECON Diagnostic aids control storage Dump control storage from either the 
dump utility control storage library dump area or 


from a disk or diskette dump file. 


$FECRE — Dump file analysis utility 1 Build a DFA file. 
$FEDFA 7.1.7 $FEDFA Diagnostic aids dump file Format dump selected areas of main, 
analysis control, and translated storage control 


blocks from either a task or a 
stand-alone dump file. 


$FEDSK 7.1.2.2 FEDSK Dump disk/diskette and patch Dump disk or diskette storage and 
7.1.3 process user modification of the data. 

$FEDSP — FEDSP Dump file analysis utility 2 Display the DFA file. 

$FEDTR 7.1.2.1 $FEDTR Dump trace file utility Print or display a system trace file’s 
7.1.2.10 content in a formatted dump. 

$FEFIX 7.3 FEFIXMNL PTF utility Apply program temporary fixes to 

system programs. 
$FEIOC 7.1.2.5 $FEIOC Diagnostic aids |/O controller Dump |/O control storage either from 
storage dump utility control storage dump area or from a 


stand-alone disk or diskette dump file. 


$SFEKEY — FEKEYMNL _ F.E. CRT window display Display on the CRT screen an 80-byte 
window of a block of data passed to it. 
$FEMCD 7.1.2.7 $FEMCD Diagnostic aids microcode Dump the following from either the 
tables dump utility control storage library or from an APAR 
diskette: 


e Prerequisite list. 
e Microcode level table. 
e Controlled patch table. 


e Free lance patch table. 
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Module 
Name 


SFEMNT 


$FEPDD 


$FEPRM 


$FEPRO 


SFEPR1 


$FEPTF 


$FESBT 


SFESI1 


$FESRV 


$FESTR 


$FESVC 


Chart 


Number Entry Point 


7.1.2.1 $SFEMNT 
7.1.7 
7.1.5 
7.1.0 


7.1.2.4 $FEPDD 


— $FEPRM 
7.1.4 FESTART 
7.1.4 FESTART 


TAu2io FEPTF 


— FESBT 


7.1.0 FESI1 
7.1.2.1 
7A,2.3 
7.1.2.4 
TAs2:5 
7.1.2.6 
IAGed 
7.1.2.8 
TA\29 
7.1.2.10 
7.1.2.11 
7.1.7 


7.1.2.6 FESRV 


7.1.2.1 $FESTR 


— $FESVC 


Descriptive Name 


Dump file maintenance 


Dump product level data 


PTF remove utility 


Standard profile retrieve routine 


(RAS overlay 1) 


Standard profile retrieve routine 


(RAS overlay 2) 


Diagnostic aids PTF log dump 


Decoding tables for SB type 


field 


Diagnostic aids copy diskette 


APAR file to disk 


Diagnostic aids dump service log 


utility 


Main storage dump utility 


Trace event descriptors (RAS 


overlay) 
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Function 


Perform the following multiple-dump- 
file-maintenance functions: 


e Allocate the existing dump file 
specified by the caller. 


e Find the last-created task dump file. 


e Display status of all existing dump 
files. 


e Display status of all existing dump 
files and allow the user to select of 
one of them. 


Print or display a product level file from a 
disk or from an APARFILE on disk. 


Provide the capability to remove PTFs. 


Retrieve trace profiles and copy them to 
a $FEPRO parameter list. 


Retrieve trace profiles and copy them to 
a $FEPRO parameter list. 


Print or display a PTF log from disk or 
from a diskette APAR file. 


Return the 5-character label for the SB 
type whose address is in POINT@1. 


Copy an APAR diskette file to a resident 
or temporary disk file. 


Print or display system service log file 
either from current log or from an APAR 
diskette file. 


Dump main storage, virtual storage, the 
control storage tables and trace 
tables/files from a task dump file or a 
stand-alone dump file on disk to a 
printer or display station. 


Provide a table for decoding SVCs, 
component IDs, and control storage 
trace events. 
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Module Chart 
Name Number Entry Point Descriptive Name Function 
$FESYS 7.1.2.3 $FESYS System area dump utility Format dump the following system areas 
either from storage or from an APAR 
diskette: 
« Disk VTOC. 
e Task work area (TWA). 
e Input job queue. 
e Spool files. 
$FETAP 7.1.2.12 $FETAP Diagnostic aids dump tape utility Dump contents of a tape volume to the 
specified printer. 
$FETI1 7.1.2.1 $FETI1 Diagnostic aids copy tape APAR Copy a tape APAR file to a resident or 
7.1.2.3 file to disk temporary disk file. 
7.1.2.4 
7.1.2.5 
7.1.2.6 
7.1.2.7 
7.1.2.8 
7.1.2.9 
7.1.2.10 
7.1.2.11 
7.1.7 
$FETRC 7.1.4 $FETRC Diagnostic aids trace utility Display events currently being traced and 
prompt for any changes. Pass new 
events to control storage. 
$FREX 8.20 $FREX Free disk space: cleanup Unsuspend command processor, update 
security and spool file, and 
cross-reference library. 
$FREE 8.20 $FREE Free disk space: phase 1 Interface with syntax checker to read 
utility control statements. 
$FREO 8.20 $FREO 00 Free disk space: initialization Initialize work space and map the used 
and free disk blocks into main storage 
as a bit mask. 
$FREQ 8.20 $FREQ_ 00 ‘Table sort routine Sorts the table entries based on start of 
allocated space. 
$FRE1 8.20 $FRE1 00 Free disk space: high Accumulate free space at high addresses 
of spindle by moving files to low 
addresses. 
$FRE2 8.20 $FRE2_ 00 Free disk space: low Accumulate free space at low addresses 
of spindle by moving files to high 
addresses. 
$FRE3 8.20 $FRE3_ 00 Free disk space: cleanup Reset format-5 entries to indicate free 
space. 
$HELP 8.11 $HELP System/36 help utility Prompt the user for the parameters on 
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Module Chart 
Name Number Entry Point Descriptive Name Function 
$HETO 8.11 $HETO System/36 OCL help table Create tables for $HELP. 
$HETP 8.11 $HETP System/36 PCE help table Create tables for $HELP. 
$HET1 8.11 $HET1 System/36 help table 1 for Create tables for $HELP. 
procedures A-C 
$HET2 8.11 $HET2 System/36 help table 2 for Create tables for $HELP. 
procedures D-F 
$HET3 8.11 $HET3 System/36 help table 3 for Create tables for $HELP. 
procedures G-O 
$HET4 8.11 $HET4 System/36 help table 4 for Create tables for $HELP. 
procedures P-R 
$HET5 8.11 $HET5 System/36 help table 5 for Create tables for $HELP. 
procedures S 
$HET6 8.11 $HETE System/36 help table 6 for Create tables for $HELP. 
procedures T-Z 
$HIST 8.12 $HIST History file display utility Display contents of history file to the 
SYSLIST device. 
$HSSCRL 8.12 $HSSCRL History file scroll Provide forward and backward scrolling 
capabilities in user copy or system 
history file. 
$SICFA 1.3.0 $ICFB SSP-ICF subsystem parameter Set parameters supplied by operator 
1.3.2 utility responses in the configuration member. 
1:3.3 
$ICFB 1.3.1 ENTRY SSP-ICF line parameter Set up line information for the selected 
configuration subsystem in the SSP-ICF member 
data set. 
$ICFC 1.3.2 $ICFC SSP-ICF BSC general Display and edit BSC subsystem 
configuration parameters parameters. 
$SICFF 1.3.3 $ICFF SNUF subsystem location Display SNUF location screen 
parameters information. 
$SICFH 1.3.2 $ICFH SSP-ICF BSC multipoint Display and edit parameters applicable 
session address configuration to multiple session BSC subsystems. 
$SICFIG 1.3.0 LDPOINT SSP-ICF subsystem Set up SSP-ICF subsystem 
configuration utility configuration data sets in the 
user-specified library. 
$SICFJ 1eSez $ICFJ SSP-ICF CCP general Display and edit parameters applicable 
configuration parameters to the SSP-ICF CCP subsystem. 
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Module Chart 
Name Number Entry Point Descriptive Name Function 
SICFK 1.3.2 $SICFK IMS subsystem PTERM Set up PTERMs (physical terminals) for 
(physical terminal) configuration the IMS/IRSS subsystem. 
$SICFLU 1.3.1 $SICFLU SSP-ICF logical unit table Create, edit, or review line logical unit 
table. 
$SICFMS 1.3.0 $SCNFIG SSP-ICF system configuration Set up for configuration requested, write 
utility config member to disk, route for further 
CNFIGICF processing. 
SICFN 1.3.3 SICFN Display Peer subsystem location Display Peer subsystem location 
configuration parameters parameters. 
$ICFO 1.3.2 $SICFO SSP-ICF 3270 general Display and edit parameters applicable to 
configuration parameters BSC 3270 emulation subsystem. 
$SICFP 1.3.2 SICFP SSP-ICF 3270 device Display and edit parameters applicable to 
configuration parameters BSC 3270 device emulation. 
$ICFO. 1.3.3 $SICFO SSP-ICF SNA 3270 Display 3270 device parameters. 
device parameters 
SICFR 1.3.1 ENTRY SSP-ICF line attributes for remote Define the remote system in the line 
system configuration configuration member. 
$SICFS 1.3.2 $SICFS SSP-ICF remote system and Get remote system and location 
1.323 location parameter configuration parameters for BSC MSRJE and SNA 
subsystems. 
SICFT 1.3.3 $SICFT SSP-ICF Finance subsystem Display Finance subsystem location 
location parameters parameters. 
SICFW 1.3.0 SICFW Write configuration member Write configuration member for current 
library. 
$1C34 1.3.2 $1C34 Display MSRJE location Display screen 34.0 (MSRJE location 
1.3.3 parameters parameters). 
$IC35 1.3.2 $IC35 Display MSRJE logon Display screen 34.0 (MSRJE logon 
1.3.3 parameters parameters). 
$IC36 1.3.2 $IC36 Display printer/punch Display screen 36.0 (MSRJE 
1.3.3 parameters printer/punch parameters). 
$1C37 1.3.2 $1C37 Display MSRJE reader Display screen 37.0 (MSRJE reader 
1.3.3 parameters parameters). 
$1C4 1 13:3 ENTRY SSP-ICF APPC location definition Prompt user to define APPC location. 
$1C43 1353 $IC43 SSP-ICF APPC location definition Prompt user to define APPC location. 
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Module 
Name 
$IDSET 


$IDSM 


$SIEDS 


SIENBL 


$IFDEB 


SIFTR 


SINIT 


$IRERD 


$SIRMAP 


$IVO1 


$IVO2 


$IVO3 


4-16 


Chart 
Number 


8.13 


8.13 


10.5.2 


10.5.2 


Entry Point 
$SIDSET 


$IDSM 


$IEDS 


SIENBL 


$IFDEB 


SIFTR 


SINIT 


$IRERD 


SIRMAP 


$I1VO1 


IVGO 


$IVO3 


Descriptive Name 


SSP-ICF DEFINEID utility 


SSP-ICF DEFINEID module 


Disable an SSP-ICF subsystem 


Initialize SSP-ICF subsystem 


SSP-ICF debug mainline 


SSP-ICF debug trace routine 


Diskette initialization routine 


SSP-ICF APPC error data 
handler 


SSP-ICF APPC mapped 
conversion support 


SSP-ICF BSCEL installation 
verification 


SSP-ICF CCP installation 
verification 


SSP-ICF CICS/VS installation 
verification 
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Function 


Route for DEFINEID syntax checking 
system file maintenance. 


Maintain remote ID list on a disk file 
for SSP-ICF system. 


Terminate an SSP-ICF subsystem task. 


Build required control blocks and give 
specified SSP-ICF subsystem control. 


Execute as a work station SRT to 
activate, deactivate, or display debug 
trace file. 


Log SSP-ICF trace entries to disk. 


Format, rename, or delete files from a 
diskette. 


Process data errors detected by APPC 
subsystem. 


Process APPC subsystem get/put 
mapped data. 


Verify installation of SSP-ICF BSCEL 
subsystem by sending/receiving a 
record. 


Verify installation of SSP-ICF CCP 
subsystem by testing for working link. 


Verify installation of System/36 
SSP-ICF subsystem and remote host 
CICS/VS system by testing for 
working link. 
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Module 
Name 


$IVO4 


$1VO5 


$LABEL 


$LABF 1 


$LABI1 


$LABST 


$LATLC 


$LATNM 
$LSLUD 


$LSSTU 


$LSTDB 


$MACHG 


SMACK 


SMACMP 


$MACOM 


SMADLT 


$MADSP 


$MAFIR 


SMAFND 


Chart 
Number 


10.5.2 


10.5.2 


8.15 


8.34.4 


8.15 
8.34.4 


8.15 


8.15 


8.15 


8.15 


10.6.11.2 


10.6.11.2 


10.6.11.2 


8.16.14 


8.16.1 


6.1.7 
6.1.9 
8.16.1 
8.16.3 
8.16.4 
8.16.14 


8.16.0 


8.16.4 


8.16.7 


8.16.11 


6.1.3 


Entry Point 


$1V04 


$IVO5 


LABSTART 


LABF 1 


$LABI1 


$LABST 


LABSTART 


LABSTART 


$LSLUD 


$LSSTU 


$LSTDB 


$MACHG 


SMACK 


$SMACMP 


$MACOM 


$MADLT 


SMADSP 


$MAFIR 


S$MAFND 


Descriptive Name 


SSP-ICF IMS/VS installation 
verification 


SSP-ICF installation verification 
for BSC 3270 subsystem 


Display VTOC initialization 
routine 


Display disk VTOC routine 


Display diskette VTOC routine 


Disk VTOC sort routine 


Tape label display routine 


Tape label sort routine 
APPN location utility 


APPN session utility 


APPN network utility 


Library directory entry change 
routine 


Save library 


COMPACTOR 


Open/close routine 


Delete routine 

Library print routine 
Library directory fast insert 
routine 


Librarian find routine 
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Function 

Verify installation of System/34 
subsystem and remote IMS/VS host 
by testing for working link. 


Verify installation of SSP-ICF BSC 
3270 subsystem. 


Initialize and route for diskette or disk 
VTOC display. 


Display on the SYSLIST device the 
disk VTOC entries. 


Display on the SYSLIST device the 
diskette VTOC entries. 


Sort the disk VTOC entries by location 
or by name. 


Display tape header label information on 
SYSLIST device. 


Retrieve and sort active tape entries. 
Dump location information to disk. 


Read session data that is logged by 
C/SNA. 


Dump network information to disk. 
Change library member name, subtype, 
and/or reference number in the 
member's directory entry. 


Save a library on a diskette. 


Compact active directory entries in 
ascending order within library directory. 


Check open/close request. 


Delete entries unless ALL is specified. 


Print library directory entries, library 
members, and system information. 


Place stack of directory entries into their 
respective alphabetic locations. 


Locate library directory entries by type(s) 
and full or partial name. 
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Module Chart 
Name Number Entry Point Descriptive Name Function 
$MAILD 6.1.9 $MAILD Library directory insert routine Place directory entry into alphabetic 
8.16.14 location within library directory. 
$MAINT 8.16.0 $MAINT Library maintenance mainline Use syntax checker routine, #USYX, to 
routine process control statement from SYSIN. 
$MALAM 6.1.1.0 $MALAM Library access method routine Perform mainline function for library 
access method. 
$MALCO 6.1.5 $MALCO Open/close module Check open/close requests. 
6.1 
$MALFN 6.1.3 SMALFN Find routine Locate directory entries by type(s) and 
8.16.4 full or partial name. 
$MALIL — $MALIL Library directory insert Place directory entry into alphabetic 
location within library directory. 
$MALOC 8.16.0 $MALOC Library allocate module Allocate user libraries, and change 
directory or member size of a library. 
$MALTL 8.16.7 $MALTL Library-to-library copy Copy library member(s) from library to 
library. 
$MAPGS 6.1.6 $MAPGS Library sector get/put routine Place modules in sector mode from 
library and pass them. 
SMAPTF 6.1.6 $FETRC PTF log handler Get, put, update, and delete entries in 
the PTF log. 
SMAPUR 6.1.5 $MAPUR Library record put routine Place source or procedure records into 
the library. 
SMARAL 8.16.13 SMARAL Library reallocate module Reallocate libraries with extents, change 
library, size, or change directory size. 
$MARCK 8.16.3 $SMARCK Library compress driver Remove gaps in the member space of 
8.16.13 the requested library. 
$MARDR 8.16.12 $MARDR Librarian from reader driver Put records from SYSIN device in 
routine requested library. 
$MARES 8.16.2.2 MARESMNL_ Main storage nucleus Initialize main storage nucleus. 
initialization program 
SMARFF 8.16.9 SMARFF Copy from file to library in Copy source and procedure members. 
record mode routine 
SMARPF 8.16.8 SMARPF Library copy from file to print in List member type and member names in 
record mode record mode file. 
$MARS 8.16.2.1 $MARS Restore libraries routine Restore user library or #LIBRARY if it 
has been saved. 
SMARTF 8.16.5 $MARTF Copy from library to file in Copy members. 
record mode routine 
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Module 
Name 
S$MAR2K 


$MAR3K 


SMASDF 


$MASPC 


$MATDS 


SMATFS 


SMATLS 


SMAXNT 


$MGBLD 


$MMSP 
$MMST 


S$MNDF 


SMNML 


$PACK 


$PDST 


$PNLM 


$POSGI 


S$POST 


$PRCED 


Chart 
Number 
8.16.3 
8.16.2.2 
8.16.3 


8.16.10 


8.18 


8.20 


9.7 


8.21 


8.22 


8.22 


8.23.1.12 


Entry Point 


$MAR2K 


$MAR3K 


$MASDF 


$MASPC 


$MATDS 


$MATFS 


$MATLS 


SMAXNT 


@MASYG 


$MMSP 
$MMST 


$SMNDF 


SMNML 


$PACK 00 


$PDST 


$PNLM 


¢$POSGI 


$POST 


$PRCED 


Descriptive Name 


Update member pointers after 
library compress 


Suspend command processor 


Print sector mode librarian file 


Specification module for library 
utilities 


Copy from file to printer in 
sector mode routine (tape) 


Copy from library to file in 
sector mode routine 


Copy from file to library in 
sector mode routine 


Update transfer table 


Message build utility 


Stop automonitor 
Start monitor 


Multinational data file 
conversion 


Multinational mainline 


Free disk space: compatibility 
phase 


Mainline link station test 


DEFINEPN phone list utility 


Special E-format diskette to 
disk 


5260 diskette copy: mainline 


Security location profile edit 
utility 
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Function 


Perform necessary updates after a library 
compress. 


Issue suspend for command processor 
TCB. 


List directory information for members in 
System/32 or System/34 sector mode 
files. 


A table of specification values used by 
syntax checker routine (FUSYX). 


List directory information for library 
members in sector mode tape files. 


Copy members. 


Copy members. 


Update system transient transfer table 


Create a message load member in a disk 
library. 


Terminate the automonitor function. 
Initiate automonitor function. 


Convert national character set data to 
multinational character set or vice versa. 


Convert source or procedure member 
data to multinational character set data 
or vice versa. 


Provide compatibility with System /34 
free disk space; performs basic $FREE 
function. 


Use the SDLC test command to verify 
that secondary SDLC stations are 
operational. 


Build or modify a load member of phone 
numbers for use by the autocall task. 


Copy a special E-format diskette file to 
disk. 


Copy diskette files processed by the 
5260 point-of-sales terminal to disk 


files. 


Update, add, delete, and/or locate 
location profiles in the user ID file. 
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Module Chart 
Name Number Entry Point Descriptive Name Function 
SPRCVT 8.23.1.16 $PRCVT System/34 to System/36 Convert System/34 password and/or 
conversion utility security file to System/36 user ID file 
and/or security file. 
$PRLST 8.23.1.5 $PRLST User profile list utility List user ID file to the SYSLIST device. 
$PRUED 8.23.1.2 START User profile edit utility Edit user profiles. 
¢$PRUID 8.23.1.1 ¢$PRUID Security user ID utility Control user ID file, password security, 
and badge security. 
$PRURS 8.23.1.4 $PRURS User ID file restore utility. Restore user !D file on disk. 
$PRUSV 8.23.1.3 $PRUSV User ID file save utility Save user ID file on disk. 
$RENAM 8.24 $RENAM Rename utility Rename files/libraries on disk. 
$SRREDT 8.23.1.8 START Resource security file edit utility | Edit file or user records. 
SRRESC 8.23.1.7 $RRESC Resource security definition Control resource security. 
utility 
$RRLST 8.23.1.11 $RRLST Resource file list utility List resource security file to the SYSLIST 
device. 
$RRSAV 8.23.1.9 SRRSAV Resource file save utility Save resource security file on disk. 
$RRSTR 8.23.1.10 $RRSTR Resource file restore utility Restore as the current resource security 
file a saved copy on disk. 
$RRTED 8.23.1.14 $RRTED Resource file edit utility Edit file for folder and folder members. 
$RRTLT 8.23.1.15 $RRTLT Resource security file list utility | List information about folders from the 
for folders resource security file. 
$SETCF 8.25 SETO0010 Work station configuration utility Update the work station communications 
configuration records. 
$SETCP 8.26 SETOOOOO Communications configuration Update the system communications 
utility configuration record. 
$SFDEP 8.27 $SFDEP Screen format diagnose and Diagnose and print source input 
print routine specifications. 
$SFDSP — $SFDSP Screen format diagnose S entry Diagnose and print S record errors. 
and print routine 
$SFFDB 8.27 $SFFDB Screen format FDT and data Build the data stream and FDT entries (if 
stream build routine required) for each format. 
$SFGR 8.27 $SFGR Screen format generator Perform mainline processing for screen 
mainline format generation. 
$SFLMM 8.27 $SFLMM Screen format load member Add, replace, or delete screen formats in 
maintenance a load member. 
$SFRSO 8.27 $SFRSO Screen format resequence Sort the data stream input field into 
routine assending sequence. 
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Module 
Name 


$SFSPC 


$SINA 


$SSINE 


SSINCT 


$SINDL 
$SINL 


$SSINR 


$SLFL 


$SMFLG 


SSMFMC 


$SMFML 


S$SMFTT 


$SMFXT 


$TCFDT 


$TCOPY 


¢$TCTFD 


$TCTSL 


$TINIT 


Chart 
Number 


7.3.2 


7.3.1 


7.3.1 


7.3.1 


8.31.2 


8.31.0 


8.31.3 


8.31.1 


8.30 


Entry Point 


$SFSPC 


SSINA 


$SINE 


SSINCT 


SSINDL 
$SINL 


$SINR 


$SLFL 


$SMFLG 


S$SMCSTART 


$S00010 


SM00010 


SC00010 


SSMFTT 


SSMEXT 


$TCFDT 


STCOPY 


¢TCTFD 


$TCTSL 


$TINIT 


Descriptive Name 


START 


NRD create 


NRD edit 


NRD conversion 


NRD delete 
NRD list 


NRD edit mainline 


Setfile utility 


SMF utility report writer 


System measurement utility 
for MLCA/ELCA 


SMF utility 


SMF task data cleanup routine 


SMF EOJ routine 


Disk-to-tape copy module 


Tape copy utility 


Tape-to-disk copy module 


Tape display module 


Tape initialization utility 
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Function 

A table of specification values used by 
the syntax checker routine for parsing 
control statements. 


Allocate a NRD file as a new file. 


Prompt for and make requested changes 
to an NRD file. 


Convert System/34 NRD file to 
System/36 NRD file or restore a 
System/36 user NRD file to the 
System/36 system NRD file. 
Delete an NRD file from disk. 
List entries in the NRD file. 


Initialize and route for NRD file 
maintenance. 


Provide procedure compatibility 
upward from System/34. 


Print an SMF report. 
Collect communications line data at 


specified time intervals for 
MLCA/ELCA communications. 


Initialize for data collection phase. 


Collect SMF data at specified time 
intervals. 


Collect communications line data at 
specified time intervals for 
non-MCLA/ELCA communications. 


Cleanup for SMF termination. 


Perform end-of-job processing for SMF 
mainline routine. 


Copy disk file to a tape file, or add disk 
file to an existing tape file. 


Copy files between tape and disk or 
SYSLIST device. 


Copy tape file to a disk file or add tape 
file to an existing disk file. 


Display the contents of a tape file on the 
SYSLIST device. 


Initialize tape. 
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Module Chart 
Name Number Entry Point Descriptive Name Function 
$TMSERV ~ 8.35 $TMSERV FMS procedure interface routine Read and process FMS utility control 
statements. 
$UASC 8.28 $UASC Display spool file entries utility | Display spool file entries placed in a user 
file by $UASF. 
SUASF 8.29 $SUASF User access to spool file utility _ Copy compressed spool file to a user file 
in expanded format. 
$XNLM 9.4.3 $XNLM X.21 phone list load-module Build or change an X.21 telephone list 
builder load member. 
$XNSH 9.4.4 $XNSH X.21 SHM line configuration load Create, update, print, or remove an X.21 
module builder SHM line configuration. 
$XREST 8.32 $XREST Extended character file restore Restore the extended character file from 
utility a diskette file. 
$XSAVE 8.33 $XSAVE Extended character file save Save the extended character file to a 
utility diskette file. 
$XTAL 9.8.4.3 $XTAL X.25 phone list utility Build or modify a list of phone numbers 
for use by an X.25 task. 
$XTCD 9.8.4.1 $XTCD Delete member Delete member during virtual circuit 
configuration. 
$XTCE 9.8.4.1 $XTCE Edit /update configuration Edit or update during virtual circuit 
configuration. 
$XTCF 9.8.4.1 $XTCF X.25 configuration mainline Route for X.25 configuration main menu 
controller input. 
$XTCM 9.8.4.1 $XTCM Main menu screen processor Edit the main menu input. 
$XTCN 9.8.4.1 $XTCN Configuration network and Edit network and logical channel data. 
logical channels 
$XTCP 9.8.4.1 $XTCP Print network and logical Print the contents of the configuration 
channels record under format. 
$XTCR 9.8.4.1 $XTCR Format and print virtual circuit Format and print configuration during 
configuration virtual circuit configuration. 
$XTCS 9.8.4.1 $XTCS Library member select Select library member for virtual circuit 
configuration. 
$XTCV 9.8.4.1 $XTCV Virtual circuit controller Route for virtural circuit menu input. 
$XTDS 9.8.4.2 $XTDS Members-with-tariff totals Control the storage and selection of a 
selection list virtual circuit member name for members 
with a tariff file. 
$XTLC 9.8.4.2 $XTLC Logical channel status Control the storage and display of the 
logical channel status for all subscribed 
channels. 
$XTMS 9.8.4.2 $XTMS Active-member selection list Control the selection and display of a 
virtual circuit's member name from 
active member in main storage. 
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Module Chart 

Name Number Entry Point Descriptive Name Function 

$XTMT 9.8.4.2 $XTMT X.25 maintenance utility Display and control maintenance option 

mainline menu. Allocate, open, and close file and 
device DTFs. 

$XTWO. 9.8.4.2 $XTWO Call wait queue status Control the storage and display of the 
call wait queue status for all active 
virtual circuit members. 

#AY AX 10.6.11 #AY AX Asynchronous subsystem Acts as an interface between all 
System/36 functions and the 
asynchronous subsystem. 

#AYML 10.6.11 #AYML Asynchronous subsystem Acts as an interface between all 

(X.25) System/36 functions and the 
asynchronous subsystem. 

#AYPM — #AYPM Line and task open routine Perform enable-time processing or 
open functions for the subsystem. 
Allocate and initialize resources. 

#BSCL 9.1.4 BSC close Close BSC files. If called by termination 
at disable time, free BSC I/O area, and 
detach BSC task if there are no other 
users. 

#BSCM 9.1.3 — BSC mainline Process all BSC data management 

9.1.1 requests and perform line initialization. 

9.1.2.1 

9.1.4 

— #BSAUTO Receive-initial initiator Set up IOB and issue SVC for 
receive-initial command. Start automatic 
response. 

9.1.1 #BSCKRI Check receive-initial command Check for pool or address response with 
NAK, EOT ACKO; start 2-second 
time-out. Start another receive- initial 
command after NAK or EOT. 

— #BSHB Operation and processor Analyze operation end interrupts and (1) 
give control to error recovery routines, or 
(2) set good completion code in IOB. 

#BSIO BSC IOS subroutine 

— #BSIW BSC wait Wait for |/O request to complete. 

9.1.1 #BSLI Line initialization routine 

9.1.1 #BSMD BSC message handler Issue messages via SSP SYSLOG for 
batch BSC. 

#BSMPEOT Send EOT subroutine 
9.1.1 #BSPOST BSC post Post data management after user 
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request is processed. 
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Module Chart 


Name Number Entry Point Descriptive Name Function 
#BSDB 9.1.1 — BSC data management Contain BSC resident data management 
9.1.2.1 subroutines subroutines required during the execution 
9.1.2.2 of a BSC task. 
9.1.4 
#BSCP Blank compression subroutine 
#BSDM BSC data management mainline Perform router function for #BSDB 
subroutines. 
#BSEXIT Exit-to-user NSI subroutine 
#BSIW BSC wait Wait for |/O request to complete. 
#BSMG GET deblocking subroutine 
#BSMO Data management move 
subroutine 
#BSMP PUT blocking subroutine 
#BSPOST BSC post Post BSC (main storage) interrupt 
handler to perform |/O operations. 
#BSXP Blank expansion subroutine 
#BSER 9.1.4 BSER BSC abnormal termination Handle BSC task processor checks. 
#BSLO 9.1.1 #BSLO Line initialization Determine line type; if multipoint, return 
to #BSCM; if other, call appropriate 
transient. 
#BSL2 9.1.1 #BSL2 Switched line calling initialization Initialize manual or autocall line. 
#BSL3 9.1.1 #BSL3 Switched line answer line Initialize manual or autoanswer BSC line. 
initialization 
#BSL4 9.1.1 #BSL4 Point-to-point nonswitched line Initialize for ENQ/ACKO exchange. 
initialization 
#BSMD 9.1.1 #BSMD BSC message handler Issue BSC messages via SYSLOG. 
9.1 
9.1. 
#BSOB 9.1.1 #BSOB BSC open Open BSC DTFs on the preopened DTF 
chain. 
#CABC 3.2.4.1 #CACM BSC data communications Allocate communications DTFs. 
3.2.4.2 allocate 
3.2.1 
#CAIC Communications task Attach communications data 
allocate /deallocate management task, allocate desired line, 


and set up CSB and ACE for each DTF. 
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Module 
Name 


#CADV 


#CAD1 


#CAD2 


#CAD3 


#CAF1 


#CAF3 


#CAMG 


#CAMI 


#CAML 


#CAM2 


HCAPT 


#CARW 


#CAR1 


#CAS1 


#CATL 


#CATM 


#CATP 


Chart 
Number 


3.2.3 


3.2.3 


3.2.1 
3.2.2 


3.2.1 
3.2.2 


3.2.1 
322.2 
3.2.3 
3.2.4.1 
3.2.4.2 


3.2.2 
3.2.3 


3.2.1 
3.2.4.1 


3.2.1 3.2.2 


3.2.1 
3.2.2 
3.2.4.2 


3.2.1 


32:2 


3.2.1 


3.2.1 


3.2.1 


Entry Point 


N/A 


#CAD1 


#CAD2 


#CAD3 


#CAF1 


#CAF3 


#CAMG 


#CAMI 


#CAML 


#CAM2 


#CAPT 


#CARW 


#CAR1 


#CAS1 


#CATL 


#CATM 


#CATP 


Descriptive Name 


Device allocate table resident 


Deallocate mainline 


Deallocate device processor 


Deallocate file processor 


Disk file allocate 


Disk file allocate 


Allocate message processor 


Allocate multiple indexed 
processing 

Allocate mainline 

Disk file allocate 

Printer allocate 


SDLC line allocate/ deallocate 


Diskette file allocate 


Special allocate mainline 


Tape allocate 


Tape allocate 


Tape allocate 
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Function 


Provide IPL with the device allocate table 
framework. 


Delete /deallocate disk files. 


Deallocate the diskette drive and 
printers. 


Perform required processing for 
deallocating a file: free space, keysort, 
and clean up reserve area. 


Set up the amount of space to get in the 
format-5 area for new files. Get 
required reserve area space. 


Calculate disk file capacities and format 
the disk space. 


Issue messages and halts for allocate. 


Perform the building and removing of 
multiple index family chains. 


Allocate devices and perform router 
processing for allocate modules. 


Complete allocate for non-output files; 
initialize control blocks for new disk files. 


Allocate spooled and nonspooled printer 
files. 


Allocate /deallocate a line for an SDLC 
task. 


Allocate diskette files. 


Allocate disk files and perform router 
processing for allocate modules. 


Allocate for standard label (SL) tape file 
processing. 


Allocate for nonstandard label (NS), 
nonlabeled (NL), and bypass-label tape 
file processing. 


Allocate for standard label (SL) tape file 
put processing. 
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Module 
Name 


#CATS 


#CCAS 
#CCAT 


#CCCM 


#CCCO 


#CCCP 


#CCGP 


#CCHM 


#CCID 


#CCJIC 


#CCJH 


#CCJQ 


#CCJS 


#CCMG 


#CCMQ 


#CCMU 


#CCMX 
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Chart 
Number 


3.2.1 


2.3.1 


2.9 


2.3.1 


2.3.2 


2.3.2 


2.3.1 
2.16 


2.3.2 


2.3.1 


2.11 


2.2 
2.3.1 
2.9 
2.16 


2.7 


Entry Point 


#CATS 


#CCAS 


#CCAT 


#CCCM 


#CCCO 


#CCCP 


#CCGP 


#CCHM 


#CCID 


#CCIC 


#CCJH 


#CCJO 


#CCJS 


#CCMG 


#CCMQ 


#CCMU 


#CCMX 


Descriptive Name 


Tape allocate 


ASSIGN command 
ASSIGN command 


CANCEL command 


CONSOLE command phase 1 


Spool CANCEL PRT command 


Spool CHANGE command 


Help text for user menus 


INFOMSG command 


Job queue management 


Job queue management 


JOBQ command (input) 


START JOBO command (input) 


MSG command phase 1 


Message file manager 


MENU command processor 


Message display 


Function 


Allocate for nonstandard label (NS) tape 
file processing. 


Process ASSIGN command. 


Process ASSIGN command. 


Process CANCEL command and inquiry 
cancel. 


Reassign system console when an |/O 
error occurs at the system console. 


Remove spool entries from the spool 
file. 


Change spool file entries and spool 
writer attributes. 


Display user-specified help text or 
default general help text. 


Process INFOMSG command. 


Perform CANCEL JOBQ, CHANGE 
JOBQ, and CHANGE JOBS commands. 


Change the status of a job, based on the 
HOLD or RELEASE JOBQ commands 


Process JOBQ command. 
Process START JOBQ and STOP JOBO 
commands. 


Process MSG command diagnostics and 
queuing. 


Process message to/from the system 
message file. 


Process MENU command. 


Display messages at work station. 
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Module Chart 
Name Number Entry Point Descriptive Name Function 
#CCOF 2.3.1 #CCOF SIGN-OFF/MODE command Process OFF and MODE command. 
2.6 
#CCPP 233.2 #CCPP Spool STOP PRT command Stop the spool writers. 
#CCPS 2.3.2 #CCPS Spool START PRT command Start the spool writers. 
#CCPT 2.3.1 #CCPT Spool RESTART PRT command __ Restart the spool writers. 
#CCPW 2.3.1 #CCPW Power OFF command Power off the system after clearing all 
active jobs. 
#CCPY 2.3.1 #CCPY PRTY command Change or set a job's priority. 
#CCRE 2.3.1 #CCRE REPLY command Process REPLY command to system 
messages. 
#CCRG — #CCRG Reply command for STATUS Process REPLY command. 
MESSAGE 
#CCRJ 2.3.3 #CCRJ Command processor MSRJE Display active MSRJE locations. 
status routine 
#CCRS — CRSOOO00O Display second-level message Retrieve second-level text. 
CRS00100 text 
#CCRT 2.3.2 #CCRT STOP/START command Process START and STOP commands. 
2.5 
#CCSC — #CCSC Command processor Display the status of the 
communications status routine © communications configuration record. 
#CCSG 2.3.3 #CCSG STATUS MESSAGE Allow system operator to view 
command handler subconsole messages. 
#CCSJ 2.3.3 #CCSJ STATUS JOBO command Display JOBO status. 
#CCSM 2.3.3 #CCSM STATUS mainline Route control to proper status module. 
2.7 
2.9 
2.13 
#CCSP 2.3.3 #CCSP Spool STATUS PRT command Display spool file status. 
#CCSO 2.3.3 #CCSO Spool STATUS WRT command Display spool writer status. 
#CCSS 2.3.3 #CCSS STATUS SESSION Display session information (pages 1 
command and 2). 
#CCST 2.3.3 #CCST STATUS SYSTASK routine Display active tasks. 
#CCSU 2.3.3 #CCSU STATUS USERS command Display active user task information. 
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Module Chart 

Name Number Entry Point Descriptive Name Function 

#CCSW 23:53 #CCSW STATUS WORKSTN command _ Display device status. 

#CCSX 2.3.3 #CCSX STATUS WORKSTN command — Build work station information for 

segment 2 segment 2 of status work station. 

#CCS2 2.3.3 #CCS2 STATUS SESSION command Display session information to the 

#2 requesting display station (pages 3, 4, 
and 5). 

#CCTD 2.3.1 #CCTD TIME command Return time of day and system date. 

#CCTU — #CCTU Subconsole TUB builder Build TUBs for subconsoles. 

#CCVA 2.3.1 #CCVA VARY command Vary operator-specified devices 
on or off. 

#CDCP — #CDCP Loader for concurrent DCP main Load and initialize concurrent DCP. 

routine 

#CDCV — #CDCV Concurrent DCP conversions Perform conversions. 

#CDKT — H#CDKT Concurrent DCP diskette Handle diskette operations. 

#CDMN — #CDMN Concurrent DCP: mainline Provide the dialog through which the 
CE/CSR may invoke and control various 
main storage diagnostic programs. 

#CDPM — #CDPM Concurrent DCP primary menu Show the concurrent DCP primary menu. 

#CDSK — #CDSK Concurrent DCP disk Locate a module in the disk C/S library 
or load a program from disk into M/S. 

#CDWS — #CDWS Concurrent DCP work station Process display requests. 

H#CHHT 2.9 #CHHT Help text Initially process Help key requests. 

#CHID — #CHID Help text lookup Retrieve help text format. 

#CHIN 2.8 #CHIN Help input processor Process help menu item selected. 

2.9 

#CHKY — #CHKY Help keyword processor Retrieve the FIB for a command or 
keyword passed from the caller and pass 
the caller the 8-character keyword or 
command name which corresponds to 
the format ID specified in the parameter 
list. 

#CHLP 2.3.1 #CHLP HELP control command Select and display the proper help menu. 

28 processor 
2.11 
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Module 


Name 


#CHMD 


#CHOH 


#CHOI 


#CHOM 


#CHOP 


#CHPB 


#CHVE 


#CIAD 


#CIAM 


#CIEP 


#CIER 


#CIFL 


#CILD 


#CILP 


Chart 
Number 


2.9 


3.1 


3.1 


3.1 


3.1 


3.1 


3.1 


8.16.3 
8.20 
8.11 


Entry Point 


#CHMD 


#CHOH 


#CHOI 


#CHOM 


#CHOP 


#CHPB 


#CHVE 


#CIAL 


#CIDL 


#CIAT 


#CIMT 


#CIEV 


#CIPP 


IEROO100 


#CIFL 


#CIIC 


#CILF 
#CIPA 


Descriptive Name 


Help command keys processor 


#CH@12: #CH@22 format 
index routine 


#CH@23: #CH@NN format 
index routine 


Home key processor 


Help output processor 


Help page-back processor 


CAPS verify routine 

OCL verb processing 

// ALLOCATE processor 

// DEALLOC processor 

OCL verb processing 

// ATTR processor 

// \NCLUDE (MRT) processor 
OCL verb processing 

// EVOKE processor 

// PROMPT processor 


Initiator error routine 


// FILE OCL statement 
processor 


// INCLUDE and // LOAD OCL 


statement processor 


Library free and procedure 
parameter access routines 
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Function 


Process command keys when help 
Support is active. 


Find the format index for #CH@12: 
#CH@22. 


Find the format index for #CH@23: 
#CH@NN. 


Process Home key, based on current 
display. 


Display help menus and prompts, help 
text for help menus and prompts, and 


command processor screens. 


Display previous help support page. 


Verify MICS for CAPS design. 


Process OCL verbs from initiator. 


Process OCL verbs from initiator. 


Process OCL verbs from initiator. 


Process all initiator-detected errors by 
setting up error MICs and processing 
operator responses. 


Process disk FILE statements. 


Process OCL verbs from initiator. 


Free libraries not being used and provide 
access to procedure parameter save 
area. 
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Module 
Name 


#CIML 


#CIMO 


#CIM1 


#CIM2 


#CIM3 


#CIM4 


4-30 


Chart 
Number 


3.1 


3.1 


3.1 


3.1 


3.1 


3.1 


Entry Point 


IMLO0010 


#CILB 
#CILC 
#CIMM 
#CISL 


#CISW 


#CIIN 


#CIJM 


#CILG 
#CINH 


#CIOF 


#CIFM 
#CIIM 
#CIRG 


#CIRS 


#CICM 
#CICO 
#CIDT 


#CISN 


#CIAB 
#CIDB 


#HCIWT 


Descriptive Name 


Initiator mainline 


OCL verb processing 

// LIBRARY processor 
// LOCAL processor 

// MEMBER processor 
// SYSLIST processor 
// SWITCH processor 
OCL verb processing 

// \NFOMSG processor 


// JOBQ, MENU, MSG, 
POWER, and VARY processor 


// LOG processor 

// NOHALT processor 
// OFF processor 

OCL verb processing 
// FORMS processor 
// \MAGE processor 
// REGION processor 
// RESERVE processor 
OCL verb processing 
// COMPILE processor 
// COMM processor 
// DATE processor 

// SESSION processor 
OCL verb processing 
// ABEND processor 
// DEBUG processor 


// WAIT processor 


Function 


Read OCL statements and pass control 
to proper OCL verb processor. 


Process OCL verbs from initiator. 


Process OCL verbs from initiator. 


Process OCL verbs from initiator. 


Process OCL verbs from initiator. 


Process OCL verbs from initiator. 
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Module Chart 
Name Number Entry Point Descriptive Name Function 
#CIPW 3.1 OCL verb processing Process OCL verbs from initiator. 
#CIPR // PRINTER statement 
processor 
#CIWK // \WORKSTN statement 
processor 
#CIRN 3.1 IRNOO100 // RUN OCL statement Process RUN statements. 
processor 
#CISU — ISU00010 Initiator procedure start setup Perform procedure startup. 
#CITD 3.1 #CIMN // FILE OCL statement Process diskette FILE statements. 
processor 
#CLAE 6.2.7 — IF ACTIVE and // EVALUATE Process active procedure test and 
processing routines evaluate statements. 
CLAC Active procedure existence 
tester 
CLEV EVALUATE statement routine 
#CLBEF 6.2.7 — SYSIN IF, existence, and and 
file size test routines 
CLBLOOOO IF block existence test 
CLEXOO000 IF file, member switch existence 
test 
CLFSOO0O0 File size substitution 
#CLEKM 6.2.7 — SYSIN keyboard, error, and Process keyboard input, errors detected 
message routines by SYSIN, and messages issued by 
SYSIN. 
CLER Issue messages for SYSIN. 
CLKB Process keyboard input for SYSIN. 
CLMP Log *, **, and pause messages for 
SYSIN. 
#CLIS 6.2.7 — SYSIN IF statement and 
substitution processing routines 
CLIF Process procedure IF statements. 
CLSB Perform procedure substitution 
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processing. 
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Module Chart 
Name Number ~~ Entry Point Descriptive Name Function 
#CLMSW 6.2.9 CLMGOO000 Interface to CLMG, CLSR, CLWO Set up messages interface. 
2.14 CLSROOOO 
2.15 CLWOQO000 
#CLSG 6.2.9 #CLSG SYSLOG Log messages to a display station 
and/or the history file, and provide for 
responses to messages. 
#CLSR 2.14 #CLSR Dual message routing Route a copy of messages that require a 
2.15 response and that were sent from the 
console back to any work stations 
attached to that task. 
#CLSS 6.2.7 #CLSS SYSIN mainline Get and process procedure statements 
#MASYL Source get from a library member or the keyboard. 
#CLST 6.2.8 #CLST SYSLIST Perform system list function. 
#CMCD 2.8 #CMCD Console display Display messages at system console or 
2.11 subconsole. 
2.12 
#CMCI 2.11 #CMCI Console light manager Manage the message waiting light for 
2.5 display stations. 
#CMCR — #CMCR Subconsole reassign Reassign subconsole messages to the 
system console. 
#CMCU 2.4 #CMCU Command processor cleanup Perform log printer, history file put, 
2.11 routine message retrieve, and message display 
2.13 for command processor. 
#CMEJ 2.11 #CMEJ Console EQJ Mark all messages responded to by EOJ 
with “**" on console. 
#CMSM — #CMSM Console management special Handle unsolicited message requests 
message from ICF. 
#CMWO 9.1.3 System logging utility Perform data management function 
9.1.4 between SYSLOG and a work station. 
#CNMID 1.2.4 $CNMIDOO System configuration utility: Prompt for and set work station logical 
modify work station IDs, subconsole assignment, and default 
printer assignment. 
#CPDK 2.8 #CPDK Dup key processor Put saved data in input field when Dup 
key is pressed. 
4-32 
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Module Chart 
Name Number Entry Point Descriptive Name Function 
#CPET 4.5.3 #CPET EOJ message purging routine Search console and subconsole queues 
10.6.3 for outstanding task messages. 
10.6.4 
10.6.5 
10.6.6 
10.6.8 
#CPHK — #CPHK Command processor Help key Route the Help key to the appropriate 
router module for processing. 
#CPIN 2.16 #CPIN OCL interface to command Provide an interface to allow commands 
processor, running under user to be issued by an SVC or OCL. 
TCB 
#CPIO 2.10 #CPIO Command processor Create WSDM parameter list and call 
input/output processor WSDM to handle save/restore requests, 
display command processor screens, 
display user menus, and display user 
menu help text. 
#CPIP 2.9 #CPIP Sign-on procedure attach Attach the sign-on procedure. 
#CPIO 2.7 #CPIO Command processor Process inquiry options, rename, and 
2.9 input/output inquiry menu other exception conditions. 
processor 
#CPKS — #CPKS Keysort processor Perform keysort on files during STOP 
system. 
#CPMF 2.9 #CPMF System error display Display error messages on system error 
display. 
#CPML 2.1 #CPML Command processor mainline Route control to appropriate command 
20 task and wait resident processor routine and wait for action. 
2.14 
2.15 
2.16 
#CPOC 2.16 #CPOC Initiator-command processor for Provide an interface to allow commands 
OCL commands running under _ to be issued by an SVC or OCL. 
the command processor TCB 
#CPON 2.2 #CPON Sign-on processor Process sign-on. 
2.9 
#CPPS 2.1 #CPPS Command processor Process procedure start requests from 
procedure start processor programs. 
ACPRL 2.6 #CPRL Work station release Release a work station from a job. 


processor 
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Module Chart 


Name Number Entry Point Descriptive Name Function 
#CPRS 2.3.2 #CPRS First operand router processor Route for command processing based 
2.3.1 on the first operand of the Cancel, 
Hold, Release, Start, or Stop 
commands. 
#CPRT 2.2 #CPRT Command processor input Initially process input routine commands 
2.3.1 router 1 to appropriate module. 
2.4 
2.7 
2.8 
#CPSC 2.1 #CPSC Command processor scheduler Schedule command processor events. 
2.5 
2.16 
#CPSI 2.1 #CPSI Command processor subtask Initialization/termination processes for 
2.2 initialization command processor subtasks. 
2.3.1 
2.4 
2.5 
2.6 
2.7 
2.8 
2.12 
2.15 
2.16 
2.17 
#CPSP 2.9 #CPSP Command processor special key Initiate processing required by special 
processor function keys on keyboard. 
#CPTC 2.1 #CPTC Command processor task-to-task Process system request inquiry, and 
2.5 communications router release functions. 
2.13 
#CPTS 2.11 #CPTS Command processor sign-on Display sign-on screen. 
displayer 
#CPT2 2.5 #CPT2 Attention key processor Process Attn key. 
#CPT3 2.12 #CPT3 System Request and Power-On Process Sys Req and Power On keys. 


key processor 


#CSAF 6.2.1 #CSAF Active format-1 access transient Read or write a format 1 from or to the 
active format area (AFA). 


#CSBT 6.2.3 #CSBT Build membership table module Build printable character table for 
8.5.1 command processor and $MAINT and 
8.16.4 SCOPY utilities. 
#CSBM Build membership table from 


source member 
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Module 


Name 


#CSMS 


#CSPL 


#CSRD 


#CSSM 


#CSSR 


#CSTR 


#CSTS 


#CSVF 


#CSVI 
#CSVJ 


#CTCP 


#CTECM 


#CTEDM 


#CTEEX 


#CTEFP 


#CTEIF 


#CTEJB 


#CTEKS 


Chart 
Number 


6.2.18 


6.2.16 


3.2.1 3.2.2 


6.2.16 


6.2.17 


6.2.17 


6.2.4 


6.2.5 


6.2.5 


5.2.3 


52:1 


5.2.2 


DZ.) 


5.2.3 


5.2.2 


Entry Point 


#COMS 


#CSPL 


#CSRD 


#CSSM 


#CSSR 


#CSTR 


SH#CSTS 


#CSVF 


#CSVI 
#CSVJ 


#CTCP 


#CTEDM 


#CTEEX 


#CTEFP 


#CTEIF 


#CTEJB 


#CTEKS 


Descriptive Name 


Diskette magazine drive search 


Phone list retrieval module 


Disk-to-diskette save/restore 


Printer interface routine (image 
verify) 


Diskette data save/restore 


Disk-to-tape save/restore 2 


Disk-to-tape save/restore 1 


Disk VTOC access transient 


Diskette VTOC read/write 
Diskette VTOC read/write 


Reserve file compress 


Termination communications 
interface transient 


Remote file termination 
processing 


Exit interface for termination 
Termination file processing 
routine 

Termination interface transient 
Termination mainline JCB 
processing 


Termination keysort 
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Function 


Search for specified file or diskette. 


Search AFA or disk for specified phone 
list. 


Transfer data from disk to diskette for 
system save/restore functions performed 
through the data storage controller. 


Send the proper image and translation 
table to either a 5211 or 3262 Printer. 


Perform SAVE and RESTORE data 
transfer. 


Transfer data from disk to tape for 
system save/restore functions performed 
through the data storage controller. 


Transfer data from disk to tape for 
system save/restore functions performed 
through the data storage controller. 


Read or write format 1's in the disk 
VTOC on disk. 


Read/write diskette VTOC and prepare. 
Read/write diskette VTOC and prepare. 


Accumulate free space within the 
bounds of the reserve file space for the 
task. 


Terminate data communications task. 
Terminate the processing of a remote 
file. 


Build or reset a termination exit block 
(TEB). 


Update format 1's, format 5s, and FSBs 
for all files used. 


Perform initial termination of step and 
job. Interface to the main terminator. 


Update JCB and prepare for next step. 


Determine which files, if any, require 
keysort. 
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Module Chart 
Name Number Entry Point Descriptive Name Function 
#CTEML 5.2.2 #CTEML Termination mainline Determine which termination routines are 
required and transfer to required 
modules. 
#CTES 8.20 #CTES Update spool file, JOBQ, Update the spool file master index and 
message file, and security file SCA file addresses. 
SCA addresses 
#CTEVI 5.2.2 #CTEVI Process alternative indexes Update format 1's, format 5s, and FSBs 
for alternative index files used. 
#CUTST 7.7 #CUTST Communications test supervisor Display screen message support. 
#CZAE 10.9.2.1 #CZAE Alert task asynchronous error Perform alert task abnormal termination. 
transient 
#CZAT 10.9.2.1 #CZAT Alert task Issue alert to host system when posted 
by SYSLOG or |/O error recovery. 
#DDCL 5.1.1 #DDCL Disk close Close disk DTFs. 
#DDDM 4.1.1 — Disk data management Provide data management router and 
4.1.2 disk data management access method 
4.1.3 drivers, base functions and subroutines. 
4.1.4 
4.1.5 
4.1.5 DDAD Add 
4.1.3 DDADMOV Move/write record 
4.1.1 DDBEOF Set cursor to BOF/EOF state 
4.1.1 DDBLOCK Disk data management request 
processor 
4.1.4 DDDL Delete record 
4.1.1 DDERROR Abnormal terminate 
4.1.3 DDESTBFU Establish buffer addressability 
4.1.4 
4.1.1 DDESTIMP Implicit update / delete 
4.1.1 DDEXTINT File extend initialization 
4.1.2 DDGT Get record, keyed get, unkeyed 
get 
4.1.2 DDGTR Get record 
4.1.5 DDIDXDP Check for invalid duplicate key 
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Module Chart 
Name Number Entry Point Descriptive Name Function 
4.1.1 DDMAIN Disk data management detail 
4.1.2 processing 
4.1.3 
4.1.4 
4.1.5 
4.1.3 DDUP Update record 
4.1.1 DDXKSORT Keysort 
#DDD2 4.1.1 #DDDM2 Disk data management index Insert an index entry with the specified 
4.1.5 insert routine key/RRN in each index in the specified 
key list. 
#DDD3 4.1.1 #DDD3 Disk data management selection Select records meeting the conditions 
expression evaluation routine specified in the selection expression 
string. 
#DDD4 4.1.1 DD4MAIN Disk data management Processes the following exception 
exception processing transient conditions: 
¢ Set cursor to BOF/EOF state. 
¢ Abnormal termination. 
¢ Implicit update/delete read. 
e File extend initialization. 
e Fix end-of-data request. 
e Set lower limit. 
e Keysort required. 
¢ Selection expression initialization. 
#DDD5 3.3.1 #DDD5 Quicksort Sort index overflow area for keyed files. 
#DDKAA 4.7 AAOQO00 Keysort control Perform keysort mainline processing. 
#DDKBB 4.7 BA0O100 Keysort preprocessor Initialize and check for sort level 
required. 
#DDKLL 4.7 LLOOOO Keysort 3-phase sort control Coordinate three phase sort in work 
area. 
#DDKMM 4.7 MMOoo00 Keysort merge function Perform keysort merge. 
#DDKSS 4.7 SS0000 Keysort sort-in-place Perform keysort without work area. 
#DDKZZ 4.7 ZZ0100 Keysort postprocessing Perform keysort cleanup. 
#DDK1A 4.7 #1 A000 Keysort phase-1 control Perform phase 1 of 3-phase keysort. 
#DDK2A 4.7 #2A000 Keysort phase-2 control Perform phase 2 of 3-phase keysort. 
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Module Chart 


Name Number Entry Point Descriptive Name Function 

#DDK3A 4.7 #3A000 Keysort phase-3 control Perform phase 3 of 3-phase keysort. 

#DDSM 4.6 #DDSM Sector data management to disk Read or write multiple sectors of data to 

or from disk files. 

#DDXL 8.23.1.8 #DDXL Disk file extend Extend the space of disk data files and 
8.23.1.12 update their active and VTOC format 1's. 
8.23.1.14 

#DD10P 3.3.1 #DD10P Disk open Phase 1 transient Perform the following open functions: 


e Check all DTFs on chain for valid 
devices specified. 


« And that all DTFs to be opened have 
been allocated. 


e If no disk DTFs on chain, call other 
device opens. 


e Perform initial diagnostic checking 
on all disk DTFs. 


e Complete processing for any ZPAM 
DTFs and route control to #DD20P 
for other disk DTF processing. 


#DD20P 3.3.1 #DD20P Disk open Phase 2 Perform the following open functions for 
(non-ZPAM) DTFs: 


« Set up required file space and SQS 
data areas. 


e Perform disk pseudo open if 
requested. 


¢ Call keysort if required. 


e If indexed file or multiple index file, 
call #DD3OP. 


#DD30P 3.3.1 #DD30P Disk open Phase 3 Perform the following disk DTF open 
functions: 


« Set up high-key data areas required 
for data files. 


« Set up a storage index for primary 
portion of the file index. 


#DEBUG — #DEBUG Dump program Generate dumps. 
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Module Chart 
Name Number Entry Point Descriptive Name Function 
#DNAE — #DNAE PC Support/36 abnormal PC Support/36 abnormal error 
error transient of the LAN error of the LAN. 
#DNICF 10.10.2 #DNICF PC Support/36 translator Provide SSP-ICF interface for PC 
Support/36 request handlers. 
#DNPM — #DNPM PC Support/36 protocol Line open function on the LAN and 
module PC Support/36. 
#DNTFS 10.10.1 #DNTFS Shared folder request Provide server function for 
10.10.2 handler PC Support/36 shared folders. 
#DNTLM 10.10.2 #DNTLM PC Support/36 router Establish and handle communications to a 
for the LAN personal computer for PC Support/36 
via a connection of the LAN. 
#DNTPM 10.10. 1 #DNTPM Virtual print request handler Provide server function for PC 
10.10.2 Support/36 virtual printer. 
#DNTRM 10.10. 1 #DNTRM PC Support/36 router Establish and handle communications to a 
personal computer for PC Support/36. 
#DNTTF 10.10. 1 #DNTTF File transfer facility request Provide server function for PC 
10.10.2 handler Support/36 transfer facility. 
#DNTVM 10.10. 1 #DNTVM Virtual disk request handler Provide server function for PC 
10.10.2 Support/36 virtual printer. 
#DPAL — #DPAL Printer alignment Give user capability to align printer 
forms. 
#DPCL 5.1.1 #DMCL Common close Close printer and work station DTFs and 
route for closing of other device DTFs. 
#DPDM 4.3.1 #DPDM Printer data management Issue IOBs to printer |OS (main storage) 
to perform requested printer |/O 
operations. 
#DPOP 3.3.1 #DPOP Printer data management open _ Process printer DTFs from common 
9.1.1 open. 
#DQEPG 4.12.1 #DQEPG Query data management (QDM) Process source expressions during QDM 
expression generator compile. 
#DQM1 4.12.1 #DQM1 Query data management (QDM) Merge records from five or more sort 
merge phase 1 buffers. 
#DQM2 4.12.1 #DOM2 Query data management (QDM) Merge records from four or less sort 
merge phase 2 buffers. 
#DQOPG 4.12.1 #DOOPG Query data management (QDM) Perform required sort code generation 
sort generator during QDM compile. 
#DQQOP 4.12.1 #DQQOP Query data management (QDM) Perform initialize processing during query 


open 
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Module Chart 
Name Number Entry Point Descriptive Name Function 
#DQQS 4.12.1 #DQQS Query data management (QDM) Sort records in output buffer(s). 
quicksort 
#DOSPG 4.12.1 #DQSPG Query data management (QDM) Perform required select code generation 
select generator during QDM compile. 
#DQWPG 4.12.1 #DOQWPG Query data management (QDM) Process WHERE statements during QDM 
WHERE generator compile. 
#DQ1DU 4.12.1 #DQ1DU Query data management (QDM) Select user-specified records and put 
data scan to user driver them in user buffer. 
#DQ2DB 4.12.1 #DQ2DB Query data management (QDM) Set up for QDM select and sort 
data scan build list driver processing (for records to be returned to 
user). 
#DQ3DD 4.12.1 #DQ3DD Query data management (QDM) Set up for QDM select and sort 
data scan to disk driver processing (for records to be written to 
disk). 
#DO4XU 4.12.1 #DQ4XU Query data management (QDM) Select records using RRN buffer in query 
index scan to user driver common. 
#DQ5XB 4.12.1 #DQ5XB Query data management (QDM) Select and sort records using RRN buffer 
index scan build list driver in query common. 
#DRCL 5.1.1 #DRCL Diskette close Close diskette DTFs. 
#DRDI 4.2.1 #DRDI Diskette data management for _ Transfer |-format files to or from a 
unspanned I-files diskette in record mode. 
#DRDM 4.2.1 #DRDM Diskette data management Process puts and gets in record mode to 
diskette. 
#DROP 3.3.1 #DROP Diskette file open transient Open diskette files. 
#DRSI 4.2.1 #DRSI Diskette data management for Transfer |-format files to or from a 
unspanned I-files in sector diskette in sector mode. 
mode 
#DRSM 4.2.1 #DRSM Diskette sector data Handle gets and puts in sector mode to 
management diskette. 
#DSAF 8.36.3 #DSAF IDDU link definition to label Prompt for data that links a definition to 
a file label. 
#DSA2 8.36.1.2 #DSA2 IDDU field selection and Prompt to verify that WHAT-USED table 
ordering entries for fields used by a format 
contain current information. 
#DSA3 8.36.1.3 #DSA3 IDDU format selection and Prompt to verify that WHAT-USED table 
ordering entries for fields used by a format 
contain current information. 
#DSBP 8.36.4 #DSBP IDDU batch print routine Print DDA information for the definition 
name requested. 
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Module Chart 
Name Number Entry Point Descriptive Name Function 
#DSCA 8.36.1.2 #DSCA IDDU communications attributes Prompt for and validity check 
communcations attributes. 
#DSCD 8.36.2 #DSCD IDDU dictionary create Create data dictionary. 
#DSCE 8.36.1.2 #DSCE IDDU evoke process Prompt for evoke build. 
#DSCF 8.36.3 #DSCF IDDU disk file create Create a disk file. 
#DSCP 8.36.1.2 #DSCP IDDU evoke process Prompt for evoke parameters selection 
and ordering. 
#DSC1 8.36.1.1 #DSC1 IDDU field attributes Prompt for field attributes. 
#DSDT 8.36.1 #DSDT IDDU definitions options Prompt for changes to definitions and 
route for definition type requested. 
#DSD1 8.36.1.1 #DSD1 IDDU field definition Prompt for changes to field definitions. 
#DSD2 8.36.1.2 #DSD2 IDDU format display Prompt for changes to format 
definitions. 
#DSD3 8.36.1.3 #DSD3 IDDU file definition Prompt for changes to file definitions. 
#DSE1 8.36.1.1 #DSE1 IDDU field edit Prompt for editing of numeric field 
definitions. 
#DSFI 8.36.5 #DSFI IDDU F and | specifications to Convert from F and | specifications 
IDDU conversion format to IDDU format. 
#DSF 1 8.36.1.1 #DSF 1 IDDU multiple field create Prompt for creating multiple field 
display definitions. 
#DSG2 8.36.6 #DSG2 IDDU format data stream Generate record-ID code and/or 
generator commmunications format data streams. 
#DSIN 8.36.0 #DSIN IDDU initialization Initialize and route for IDDU processing. 
#DSLL 8.36.3 #DSLL IDDU label list Read VTOC and list specified file labels. 
8.36.9 
#DSLS 8.36.1 #DSLS IDDU dictionary list List data dictionary names for selection 
8.36.3 by user. 
8.36.8.1 
8.36.8.2 
8.36.8.3 
#DSL1 8.36.8. 1 #DSL1 IDDU member list 1 List field definitions. 
#DSL2 8.36.8.2 #DSL2 IDDU member list 2 List format definitions. 
#DSL3 8.36.3 #DSL3 IDDU member list 3 List file definitions. 
8.36.8.3 
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Name Number Entry Point Descriptive Name Function 
#DSM2 8.36.9 #DSM2 IDDU format mark Use affected format list to update 
applicable DDA fields. 
#DSM3 8.36.9 #DSM3 IDDU file mark Use affected files list to update 
applicable DDA fields. 
#DSOD 8.36.2 #DSOD IDDU data dictionary options Prompt for type of dictionary option and 
display route for requested option. 
#DSOF 8.36.3 #DSOF IDDU disk file options display Prompt for disk file option to be 
performed against specified disk label. 
#DSOP 8.36.4 #DSOP IDDU print options display Prompt for print option to be performed 
against specified definition. 
#DSOR 8.36.1.1 #DSOR IDDU rename options display Prompt for and rename a file, format, 
8.36.1.2 field, or dictionary. 
8.36.1.3 
8.36.2 
#DSO1 8.36.1.1 #DSO1 IDDU field options Prompt for and process field options for 
definition. 
#DSO2 8.36.1.2 #DSO2 IDDU format options Prompt for and process format options 
for definition. 
#DSO3 8.36.1.3 #DSO3 IDDU file options Prompt for and process file options for 
definition. 
#DSP1 8.36.4 #DSP1 IDDU field print routine Print requested field definitions. 
#DSP2 8.36.4 #DSP2 IDDU format print routine Print requested format definitions. 
#DSP3 8.36.4 #DSP3 IDDU format print routine Print requested file definitions. 
#DSRB 8.36.6 #DSRB IDDU dictionary rebuild Rebuild requested dictionary. 
#DSRD 8.36.2 #DSRD IDDU dictionary revise Change dictionary description and/or 
dictionary security. 
#DSRI 8.36.1.2 #DSRI IDDU record-|ID codes Display requested record-|ID codes. 
#DSS1 8.36.5 #DSS1 IDDU field exit Update data dictionary with field 
definition changes. 
#DSS2 8.36.5 #DSS2 IDDU format exit Update data dictionary with format 
definition changes. 
#DSS3 8.36.5 #DSS3 IDDU file exit Update data dictionary with file definition 
changes. 
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Module Chart 
Name Number Entry Point Descriptive Name Function 
#DSVD 8.36.1.1 #DSVD IDDU confirm delete Confirm a delete request from any 
8.36.1.2 options display. 
8.36.1.3 
8.36.2 
#DSVW 8.36.1.1 #DSVW IDDU confirm WHERE-USED Display WHERE-USED information for a 
8.36.1.2 definition. 
8.36.1.3 
#DSV2 8.36.9 #DSV2 IDDU format verification Confirm that changes made to a 
low-level definition will not result in 
errors in a higher-level definition. 
#DSV3 8.36.9 #DSV3 IDDU file verification Confirm that changes made to a 
low-level definition will not result in 
errors in a higher-level definition. 
#DSWC 8.36.8.2 #DSWC IDDU copy WHAT-USED Copy a list of items used by a file or 
8.36.8.3 definitions format definition. 
#DSWU 8.36.4 #DSWU IDDU WHERE-USED tracking Build a list of affected items used by a 
8.36.9 and control particular field, format, or file definition 
and place it in the dictionary control 
member's DDA. 
#DSXD 8.36.1.1 #DSXD IDDU long comment display Prompt for long comment. 
8.36.1.2 
8.36.1.3 
8.36.2 
#DSX1 8.36.1.1 #DSX1 IDDU field exit Update data dictionary with field 
definition changes. 
#DSX2 8.36.1.2 #DSX2 IDDU format exit Update data dictionary with format 
definition changes. 
#DSX3 8.36.1.3 #DSX3 IDDU file exit Update data dictionary with file definition 
changes. 
#DSY1 8.36.8. 1 #DSY1 IDDU copy field selection Prompt for and copy requested field 
definitions. 
#DSY2 8.36.8.2 #DSY2 IDDU copy format selection Prompt for and copy requested format 
definitions. 
#DSY3 8.36.8.3 #DSY3 IDDU copy file selection Prompt for and copy requested file 
definitions. 
#DSZDD 8.36.5 #DSZDD IDDU data dictionary processing Create data dictionary definitions from 
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Name Number Entry Point Descriptive Name Function 
#DSZIN 8.36.5 #DSZIN IDDU F and | specifications Initialization for data dictionary 
conversion initialization processing. 
#DSZSR 8.36.5 #DSZSR IDDU F and | specifications Process all source members specified in 
source processing the IDDUXLAT procedure parameters. 
#DSZ1 8.36.8.1 #DSZ1 IDDU copy field Prompt for and copy specified field 
definitions. 
#DSZ2 8.36.8.2 #DSZ2 IDDU copy format Prompt for and copy specified format 
definitions. 
#DSZ3 8.36.8.3 #DSZ3 IDDU copy file Prompt for and copy specified file 
definitions. 
#DTCC 2.3.3 #DTCC Display status of system Display communications lines status 
communications configuration information. 
#DTDC 2.3.3 #DTDC Command processor status Display communications lines status 
command—communications information. 
#DTDL 2.3.3 #DTDL Display communications line Display communications line dynamic 
activity activity. 
#DWDM 4.4.0 #DWDM Work station data management Call work station data management 
router resident routines. 
#DXET 10.9.1 #DXET C & SM change management Terminate change management. 
termination 
#DXIN 10.9.1 #DXIN C & SM change management Initialize for change management. 
initiator 
#DXML 10.9.1 #DXML C & SM mainline Perform mainline processing for change 
management. 
#EMAD 10.8.3 EMGOA 3270 BSC device emulation Initialize display for emulation. 
initialization 
#EMAX 10.8.3 EMEWA 3270 BSC device emulation Emulate 3277 display. 
driver 
#EMBX 10.8.3 #EMBX 3270 BSC emulation termination Detach device from 3270 emulation. 
10.8.4 exit routine 
#EMEI —— EMFGO 3270 BSC emulation installation Determine the name of the translation 
routine tables for the 3270 |/O interface code 


and 5250 character set. 
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Module 
Name 


#EMFP 


#EMFX 


#EMO101 
through 
#EM1516 
#EMSD 
#ESAD 
#ESAX 


#ESBX 


#ESFI 


#ESFP 


HESFX 


#ESPI 


#ESSD 


#ESO116 
through 
#ES1916 


#ES9D 


#FEIN 


Chart 


Number 


10.8.3 
10.8.4 


10.8.3 
10.8.4 


Entry Point 


EMFGO 


#EMFX 


#ESBX 


ESFGO 


ESFGO 


#ESFX 


ESGO5 


DSCPNT 


#FEIN 


Descriptive Name 


3270 BSC emulation EM3270 
procedure processor 


3270 BSC emulation abnormal 
exit routine for procedure 
processor 


3270 BSC emulation translate 
tables 


3270 BSC device emulation 
printer driver 


3270 SNA device emulation 
intialization 


3270 SNA device emulation 
mainline 


3270 device emulation 
termination exit routine 


3270 device emulation, 
installation routine 


3270 SNA emulation ES3270 
procedure processor 


3270 SNA emulation termination 
exit routine procedure processor 


3270 device emulation, SNA 
printer initialization 


3270 SNA SCS LU1 printer 
mainline 


3270 SNA emulation translate 
tables 


3270 SNA DSC LU3 printer 
mainline 


Service log allocate /terminate 
transient 
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Function 


Verify the procedure parameters. 


Perform abnormal termination for 
HEMEP. 


Non-executable load modules that 
provide foreign language translate tables 
for device drivers. 


Emulate 3288 Printer. 


Initialize display for emulation. 


Emulate 3277 display. 


Detach device from 3270 emulation. 


Determine the name of the translation 
tables for the 3270 I/O interface code 
and 5250 character set. 


Verify the procedure parameters. 


Perform abnormal termination for module 
H#ESFP. 


Initialize printer for emulation of a 328x 
Printer. 


Emulate 3287 Printer in SCS format. 


Non-executable load modules that 
provide foreign language translate tables 
for device drivers. 


Emulate 328x Printer in DSC format. 


Allocate the service log file for a service 
logging session or terminate the service 
logging session. 
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Name Number Entry Point Descriptive Name Function 
#FERX 7.4.1 #FERX Service log recording transient Log data to the service log file. 
#FESLG 7.1.2.10 #FESLG Start/stop disk trace logging Start or stop logging of trace tables to 
7.1.5 disk for a specific trace table. 
#FETDP — #FETDP Main storage task dump Determine the output device for a task 
program (router) dump, and load in the appropriate device 
routine. 
#FETFD — #FETFD Main storage task dump Output a task dump to a disk dump file. 
program (disk routine) 
#FETLK 7.1.5 #FETLK Diagnostic aids APAR utility 4 = Perform APAR termination processing. 
#FETPR — #FETPR Main storage task dump Format and print a task dump. 
program (printer routine) 
#FETRD — #FETRD Main storage task dump Output a task dump onto an APAR 
program (diskette routine) diskette. 
#GAER — #GAER EXTN transient for RCL Determine which RCL entries are 
recovery necessary when the RCL is full. 
#GAIC — #GAIC EXTN transient for input Perform EXTN processing for input 
and CGU and CGU operations. 
#GAML 2.5 GAMINIT EXTN task mainline Perform mainline processing for 
4.4.1 ideographic character devices on the 
4.4.2 system. 
9.6.4 
#GAPO — #GAPO EXTN printer transient Perform printer EXTN processing. 
#GAPR 4.3.1 #GAPR EXTN character print scan Search printer data stream for EXTN 
4.5.3 character codes requiring translation to 
RAM address. 
#GASR 4.4.1 #GASR EXTN task save/restore RCL Save or restore RAM contents list 
4.4.2 (RCL) for a work station. 
#GAWT — #GAWT EXTN where-to-go tables Contains where-to-go tables in case 
OXRF has run. 
#GCAC 9.5 #GCAC MLCA/ELCA autocall dial Process switched-line call requests 
module from protocol link control. 
#GCAT 9.4.0 #GCAT #GCFR (REQUEST X) abnormal Perform cleanup for REQUEST X 
9.4.2 termination abnormal termination by deallocating 
line, freeing data areas, and posting the 
X.21 MLCA/ELCA dial task. 
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Module Chart 

Name Number Entry Point Descriptive Name Function 

#GCFR 9.4.2 #GCFR X.21 dynamic registration/ Process operator requests for 

cancellation task registration for, or cancellation of, 
Public Data Network services. 
#GC21 9.4.1 #GC21 X.21 MLCA/ELCA autocall task Load X.21 connection task and process 
9.1.1 autocall requests from protocol link 
control. 

#HCER 10.9.3 #HCER Session take-down Perform processing required when 
session is canceled by either System/36 
or host. 

#HCIN 10.9.3 #HCIN 3270-5250 translate Process received data. Data stream 
translation 3270-5250. 

#HCKB 10.9.3 #HCKB Keyboard map management Perform keyboard map functions (display, 
change) initiated from keys procedure. 

#HCML 10.9.3 #HCML Remote management mainline Acts as an interface to work station data 
management for inbound and outbound 
data. 

#HCOUT 10.9.3 #HCOUT 5250-3270 translate Process data to be transmitted. Data 
stream translation 5250-3270. 

#HCVY 10.9.3 #HCVY Session and device bring-up Perform session bring-up and device 
bring-up. 

#HFCOPY 6.2.10 #HFCOPY High-speed history file copy Copies the history file to a user file 
when history file becomes full. 

#HFPU 6.2.10 #HFPU History file put Put OCL, error messages, and operator 
responses in the history file. 

#HPDA 4.4.2 #HPDA Abnormal termination Perform cleanup for help task 
abnormal termination. 

#HPDO 4.4.2 #HPDO Application help document Browse through an online document. 

processor 
#HPKP 4.4.2 #HPKP Help key processor task Display help formats. 
WAIT 

#HPLM 4.4.2 HPDA Help support list maintenance Documentation is provided at each 
HPCLR routine module entry point. 
HPDG 

#HPMN — #HPMN Application help menu read Read through an online document 

task (evoked by READINFO procedure). 

#HRML 10.10. 1 #HRML SSP-ICF request handler Provide SSP-ICF server program 

10.10.2 interface. 
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Name Number Entry Point Descriptive Name Function 
#IANA 10.6.7 — C/SNA half-session allocate Allocate or deallocate C/SNA 
10.6.10 nonresident subroutine half-session control blocks (SNUB, 
LUSCB, and PHUB). 
#IANB — #1ANB C/SNA session reset Reset C/SNA session. 
#1ANC 10.4.2 #IANC Common session control Process requests and responses for 
session activation and deactivation. 
#IANE 10.3.1 #IANE SSP-ICF C/SNA protocol Initialize for C/SNA processing. 
processor 
#IANJ 10.4.0 #IANJ C/SNA link manager Handle exception conditions for C/SNA. 
HIANL 10.4.1 #HIANL LU network services (for LU6.2) Perform FMD requests, notify command, 
10.4.2 and term-self command network 
services functions. 
#IANO 10.4.1 #IANO LU network services Perform FMD requests, notify command, 
10.4.2 and term-self command network 
services functions. 
#HIANP 10.4.2 #IANP PU network services Perform configuration and maintenance 
services. 
#IANS 10.4.0 #IANS Single-node control point Process C/SNA-detected errors. 
(SNCP) configuration services 
#HIANT 10.4.1 #HIANT Transmission control-session Perform session service and activation / 
control deactivation functions. 
#IANX — #HIANX C/SNA error exit program Receive control when the C/SNA task 
Causes a program check. 
#HIANY 10.4.1 HIANY C/SNA data flow control (DFC) Perform all required processing for 
send/receive (for FMP-4) sending and receiving DFC 
commands/responses and subsystem 
requested data messages/responses. 
HIANZ 10.4.1 HIANZ C/SNA data flow control (DFC) Perform all required processing for 
send/receive (for FMP-19) sending and receiving DFC 
commands/responses and subsystem 
requested data messages/responses. 
#IAN1 — #HIAN1 C/SNA send message Send a message unit (MU) or a SIG to a 
SNA procedure. 
#HIAN4 10.4.0 #HIAN4 C/SNA mainline Perform mainline and routing functions 
10.4.1 for C/SNA. 
10.4.2 
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processor 


Module Chart 
Name Number Entry Point Descriptive Name Function 
#IBCI 10.6.4 #IBCI SSP-ICF CICS/VS subsystem Establish and maintain one or more 
logical communications sessions 
between the System/36 and CICS/VS 
via BSC. 
#IBGA 10.6.3 #IBGA SSP-ICF BSC subsystems error Process abnormal termination for all 
10.6.4 exit routine SSP-ICF BSC subsystems. 
10.6.5 
10.6.6 
#IBGT — #IBGT SSP-ICF EBCDIC/ASCII Translate EBCDIC to ASCII or ASCII to 
translation EBCDIC for SSP-ICF functions. 
#|IBHE 10.6.1 IBHE SSP-ICF BSC asynchronous Perform abnormal termination processing 
error exit for the BSC mainline task. 
#IBHL 10.6.1 — SSP-ICF BSC link control task Provide link control to support 
System/36 BSC users. 
#IBHP 10.3.1 IBHP SSP-ICF BSC protocol module Perform SSP-ICF BSC open functions 
at enable. 
#IBIDM — — IMS/IRSS data management (Link-edited in #IBIM.) 
#IBILM — — IMS/IRSS subsystem line (Link-edited in #IBIM.) 
manager 
#IBIM 10.6.3 #IBIxxx SSP-ICF IMS/IRSS subsystem IMS/IRSS link-edited object module. 
Includes the following source modules 
(listed under their respective directory 
entries): #IBIDM, #IBILM, #IBIOM, 
#IBISG, #IBISP, and #IBIWM. 
#IBIOM — — IMS/IRSS queue management (Link-edited in #IBIM.) 
subroutines 
#IBISG — — IMS/IRSS SY block generator (Link-edited in #IBIM.) 
#IBISP — — IMS/IRSS SY block processor (Link-edited in #IBIM.) 
#IBIWM — — IMS/IRSS work manager (Link-edited in #IBIM.) 
#IBLA 10.4.5 IBLXACQ SSP-ICF BSCEL acquire Process acquire operation for BSCEL 
operation code processor subsystem. 
#IBLC 10.6.6 IBLCERR 1 SSP-ICF BSCEL line error Process line error messages for 
processor 1 BSCEL subsystem. 
#IBLD 10.6.6 IBLDDABL SSP-ICF BSCEL disable Disable BSCEL subsystem. 
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Module Chart 
Name Number Entry Point Descriptive Name Function 
#IBLE 10.6.6 IBLEERR2 SSP-ICF BSCEL line error Complete processing of line errors 
processor 2 for BSCEL subsystem. 
#IBLF — multiple SSP-ICF BSCEL subsystem F Process operation failures for the 
SSP-ICF transient SSP-ICF BSCEL subsystem. 
#IBLM 10.6.6 — SSP-ICF BSCEL subsystem Interface between all System/36 
mainline functions and the BSCEL subsystem. 
#IBLN 10.6.6 IBLXNABL SSP-ICF BSCEL subsystem Enable the BSCEL subsystem. 
enable 
#IBLR — IBLREOSA SSP-ICF BSCEL abnormal Perform abnormal termination for the 
termination BSCEL subsystem. 
#IBPC 10.6.5 — SSP-ICF CCP subsystem Interface between all System/36 
mainline functions and the CCP subsystem. 
#ICCNT 10.2 ICSPGMS SSP-ICF control resident Provide an interface from SSP-ICF 
subroutines subsystem tasks to the command 
processor procedure start SVC interface. 
#ICD2 2.3.3 #ICD2 Command processor status Display status of SSP-ICF sessions. 
SSP-ICF sessions command 
#ICD2 — #ICD2 Subsystem session status Process requests for subsystem session 
command processor Status. 
#ICDB 10.1 #I1CDB SSP-ICF data management #ICDB is called by #ICDM to perform 
end session processor subroutine execution of subsystem 
instructions. 
#ICDC 10.1 #ICDC SSP-ICF data management Issue all SSP-ICF data management 
message processor error messages, and error messages for 
every hex 80 or greater return code in 
a SUB. 
#ICDI 2.3.3 #ICDI Subsystem status command Process requests for subsystem status. 
processor 
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Module Chart 
Name Number Entry Point Descriptive Name Function 
#ICDM 10.1 #ICDM SSP-ICF data management Called whenever a user issues an SVC to 
mainline data management with a device code for 
an SSP-ICF session and the Interactive 
Communications Feature has been 
configured on the system. lf the 
operation is for a work station, transfer 
control to work station data management 
to handle the operation. If the operation 
is for an Interactive Communications 
Feature session, validate the operation 
and post the appropriate subsystem to 
handle the operation. Within the user's 
DTF is a work station parameter list 
(WSPL). Within the WSPL is a 2-byte 
op-code modifier and op-code that 
instruct #ICDM the required operation(s) 
to perform. 
#ICDN 10.1 #ICDN SSP-ICF data management Called to continue the processing of an 
mainline SSP-ICF user request. #ICDN validates 
the operation and posts the appropriate 
subsystem to handle the operation. 
#ICDU 10.1 #ICDU Interface between IDDU Called when user request is an IDDU 
and #ICDM request for communications. Validates 
the operation and converts IDDU 
communications format to valid WSPL 
operation code. Calls #ICDM to 
continue processing. 
#IED1 10.3.2 DS100000 Initial disable Perform initial disable processing. 
10.6.4 
10.6.5 
10.6.6 
10.6.8 
#IED3 10.3.2 DS300000 Free LOC disable Dequeue and free a LOC element and 
10.6.8 free the associated phone list. 
#IEDS 10.3.2 Final disable Perform final disable processing. 
10.6.4 
10.6.5 
10.6.6 
10.6.8 
10.8.2 
#IELOC — #IELOC Enable implicit APPN location Build an APPN LOC. 
#IEN3 10.3.1 N30O00000 Enable multiple locations Build LOCs for locations being enabled. 
#IESGB — #IESBG Build/free SGB Build and free SGBs for APPN. 
#ILDSS 10.6.11.1 #ILDSS APPN directory services Conduct and reply to APPN directory 
10.6.11.2 searches. 
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Module Chart 

Name Number Entry Point Descriptive Name Function 

#ILMGR 10.6.11.1 #ILMGR APPN control point manager Control CPSVCMG session. 

#ILRSS 10.6.11.1 #ILRSS APPN route selection Maintain network topology and calculate 

10.6.11.2 services search and session routes. 

#ILSND 10.6.11.1  #ILSND APPN send Transmit data to adjacent nodes for local 
control point. 

#ILTR6 10.6.11.1 #ILTR6 APPN target Receive data from adjacent control points. 

#IPLPROC 1.1.5 N/A IPL sign-on procedure Invoke IPL overrides according to user 
responses to prompts. 

Note: This is a system procedure, not 
an SSP load member. 

#IQMA 10.6.9 #IQMA Peer asynchronous error exit Terminate task and clean up control 
blocks after abnormal termination, 
processor check, or 2K-page failure 
in Peer task. 

#IOMB — #IQMB Build SPUB Peer SSP-ICF Build SPUB for SSP-ICF Peer subsystem 

transient task, abnormal termination, processor 
check, or 2K-page failure in Peer task. 

#IQMD — #IQAOR Attach manager request decode Process received attach FMH5 by setting 

Peer SSP-ICF transient up for program start. 

#IOMQ 10.6.9 #IQMQ SSP-ICF Peer free SSQS/CQS Free unneeded SOS/TWS and dequeue 
messages. 

#IOMS 10.3.1 lIQMS SSP-ICF Peer protocol Activate the SDLC task and allocate 

processor TWS. 

#IQSML 10.6.9 lOSxxx SSP-ICF Peer subsystem Perform all SSP-ICF data management 

mainline operations requested of the Peer 
subsystem by the end user. 

#IRAE 10.6.10 #IRAE APPC subsystem asynchronous’ Handle program and enable errors in 

error exit the APPC subsystem. 

#IRATR 10.1 #IRATR APPC subsystem get-attributes Retrieve information for get-attributes 

routine and get-status operations. 

#IRCE 10.6.10 #IRCE LU services model asynchronous Handle program and other errors 

error exit detected by the APPC subsystem source 
and target LU service models. 

#IRCNOSS ~~ 10.6.10 #IRCNOSS APPC LU service model—source Process change number of sessions 
requests from local application programs. 

HIRCNOST = 10.6.10 #IRCNOST APPC LU service model-—target Process change number of sessions 
requests from remote systems. 

#IRDA 2.3.3 #IRDA APPC status Display status for SSP-ICF APPC 
subsystem. 
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Module Chart 

Name Number Entry Point Descriptive Name Function 

#IRML 10.6.10 #IRML APPC subsystem mainline Process all requests issued to APPC 
subsystem. 

#IRPM 10.3.1 #IRPM APPC subsystem protocol Update LOC and SCT during enable. 

processor 

#ISEA 10.6.2 #ISEA SSP-ICF Intra end-of-step Provide end-of-step abnormal 

abnormal processor processing for the SSP-ICF Intra 
subsystem. 

#ISEF 10.6.2 #ISEF SSP-ICF Intra unsuccessful Provide evoke failure processing for the 

program start (evoke) SSP-ICF Intra subsystem. 
processor 

#ISEX 10.6.2 #ISEX SSP-ICF Intra disable and Get control from SSP-ICF disable, or a 

asynchronous error processor soft processor check in the Intra task. 

#ISMA 10.6.2 ISMxxxx SSP-ICF Intra subsystem Provide user programs the ability to use 

mainline SSP-ICF to start and communicate with 
other programs on the same system. 

#ITHDA 10.8.1 3270 BSC interrupt handler Disable 3270 emulation after a disable 

asynchronous error exit command or an interrupt handler 
processor check. 
#ITHML 10.8.1 — 3270 BSC device emulation Emulate 3271 control unit. 
interrupt handler 

#ITSCP 10.3.1 #ITSCP 3270 emulation: Assign system queue space, attach 
communications protocol interrupt handler, and allocate line and 
module load microcode. 

#HITSET 10.8.2 3270 BSC subsystem error exit Process abnormal termination on 

routine subsystem op-end or interrupt handler 
ABEND. 

#ITSPI 10.8.2 — 3270 BSC subsystem Interface between all System/36 
functions and the 32/70 BSC subsystem. 

#ITSX1 10.8.2 3270 subsystem resource Release all buffers and control blocks 

deallocate processor owned by subsystem. 

#IUSBC — #IUSBC SNUF BIND check processor Check BIND images received from 
C/SNA. 

#IUSD — #IUSD Evoke data formatting routine Format the user's input on an evoke 
operation to the proper format for 
transmitting to the host. 

#IUSF 10.6.7 multiple SSP-ICF SNA Upline Facility Provide an interface between SSP and 

(SNUF) mainline SSP-ICF at SNUF task’s initial startup. 
Process event completions. 
#HIUSN 10.3.1 #IUSN SNUF enable protocol processor Perform initial processing required before 


mainline is given control. 
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Name Number Entry Point Descriptive Name Function 

#IUSS — #1USS Procedure start processor Process procedure start requests from 
host. 

#IUSX 10.6.7 #IUSX SSP-ICF SNUF error processor = Perform abnormal termination processing 
for the SNUF subsystem. 

#IUS4 — #IUS4 Process STSN command When a set and test sequence numbers 
command is received, this routine is 
called. 

$iIUS5 — #IUS5 Exception handling routine for Receive control when a data flow control 

DFC commands received command is received and is not 
expected. 

#HIZAET 10.8.5 SNA 3270 termination exit Handle abnormal termination of SNA 

routine 3270 subsystem. 

#IZBND 10.8.5 SNA 3270 bind check routine Ensure bind parameter are acceptable. 

#IZDBL 10.8.5 SNA 3270 disable routine Handle normal disable or termination of 
an SCT or LOC. 

#IZMNL 10.8.5 #IZMNL 3270 SNA mainline Interface between all System/36 
functions and the 3270 SNA subsystem. 

#IZSCP 10.3.1 #IZSCP SNA 3270 protocol processor Initialize to allow enabling of subsystem. 

10.8.5 

#IZSRT 10.8.5 IZSNx SNA 3270 interface subroutines Process SNA 3270 event completions. 

HRSTAT 10.1 HRSTAT PC Support/36 get-attributes Retrieve information for get-attributes 

routine and get-status operations. 

#LNAT 9.10.3 #LNAT Initialization/termination Perform initial abnormal termination for 

abnormal termination of the errors detected by initialization or 

LAN termination of the LAN, and perform 
abnormal termination for all processes 
of the LAN. 

#LNIT 9.10.1.1 #LNIT Initialization/termination of the Process line open requests from SNA, 

9.10.1.2 LAN handle open station and enable IOBs 
9.10.2 from the SNA, process all messages for 


the LAN, and complete processing for 
terminate/detach from the LAN. 


#MACG 6.1.9 #MACG Library member change routine Change member name, subtype, and/or 
reference number. 
#MADT 6.1.7 #MADT Library directory entry delete Delete specified non-IBM-supplied 
routine members from a library. 
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Module 
Name 


#MAFLB 


#MAMPM 


#MANOP 


#MAPR 


#MASEC 


#MASFN 


#MASGT 


#MASYL 


#MAXRF 


#MAXT 


#MERP 


#MLCK 


#MLCT 


#MGRET 


Chart 
Number 


6.1.4 


6.1.4 


8.16.4 


6.2.2 


9.3.1 


2.5 
9.3.1 


6.2.6 
6.2.8 


Entry Point Descriptive Name 

#MAFLB Find a library routine 

@CSVF Disk VTOC read/write 

#MAMPM Library member protection 

#MANOP No-op routine for 
cross-reference resolver 

#MAPUR Library record put routine 

#MASEC Library sector get/put 

#MAFLB Single name find routine 

#MASGT Source library find/get routine 

@MASYG Source library get routine 
include and load version 

#MAXRF Cross-reference resolver 
resident 

H#MAXT Librarian extent 

#MERP MCR data management error 
recovery 

#MLCK MLCA/ELCA controller check 
handler 

#MLCT MLCA/ELCA controller recovery 

MGROOO0O Message retrieve routine 


This document contains restricted materials of IBM. LY21-0590-4 
©Copyright IBM Corp. 1983, 1984, 1985, 1986 


Function 


Find a library by 8-byte name, and set 
up for its use. 


Interlock library member. 


Handles errors when SSP module in a 
WTG table is not found in the system 
library 


Place source or procedure records into 
the library. 


Get modules in sector mode from the 
library and pass them to a calling 
routine. 


Find a library member in either the 
system or user library. 


Find either source or procedure members 
when requested. 


Get records from source or procedure 
members in the requested library. 


Resolve absolute disk addresses of 
routines in where-to-go (WTG) tables so 
those routines can be loaded without the 
use of system find. Also, resolve format 
member index tables in modules. 


Create a library extent when a full library 
exists on a $MAINT to library sector 
mode copy. 


Perform error recovery for the MCR data 
management task. 


Initiate and control MLCA/ELCA error 
recovery procedures. 


Provide interface between the error 
processing transient (#SVERP) and the 
MLCA/ELCA error recovery task (#GCCE) 
by attaching #GCCE. 


Retrieve a message from the specified 
message member. 
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Module 


Name 


#MIML 


#MION 


#MNER 


#MRER 


#MRON 


#MNER 


#MSBEL 


#MSBFL 


#MSBGL 


#MSBHL 


#MSBIX 


#MSBLD 


#MSCFG 


#MSCPR 
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Chart 
Number 


4.9 


4.9 


4.9 


4.9 


Entry Point 
#MIML 
#MION 
#MNER 
#MRER 
#MRON 
#MNER 
#MSBEL_ 0O 
#MSBFL_O 
#MSBGL_ 0 
#MSBHL_0O 
MSIX0000 
#MSBLD_ 0 
MSIPLMNT 
MSCPRMNT 


Descriptive Name 


MCR data management mainline 


MCR data management mainline 


Multinational conversion error 
utility 


MCR data management error 
recovery 


MCR data management open 


Multinational conversion error 
utility 


IPL file rebuild: initialization and 


non-indexed file checking 
module 


IPL file rebuild: indexed file 
check module 


IPL file rebuild: date chain 
module 
IPL file rebuild: VTOC 


compactor 


Index extraction 


IPL file rebuild: initial module 


Main storage IPL overrides 


Command processor function 
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Function 


Provide data management mainline 
routing for the MCR device. 


Provide data management functions for 
the MCR device. 


Issue errors for the #MNER procedure. 


Perform error recovery for the SUBR25 
subroutine. 


Provide data management open routine 
for the SUBR25 subroutine. 


Issue error messages for the #MNER 
procedure. 


Initialize common area, and verify and 
correct VTOC format 1's for 
non-indexed files. 


Verify and correct VTOC format 1's for 
indexed files. 


Ensure all format 1’s for files with the 
same label and different dates are 
properly marked. 


Place all format 1’s in the minimum 
number of sectors possible. 


Get keys from indexed file data and 
build index. 


Initialize common area for IPL file 
rebuild. 


Prompt for and process override 
requests from the system operator. 


Initiate sign-on sequence and perform 
sign-on initialization for configuration 
records, subconsole, and other 
miscellaneous functions. 
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list and set dependency bits 


Module Chart 

Name Number Entry Point Descriptive Name Function 

#MSIPL Iks MSIPLMNT Main storage IPL phase 3 Initiate sign-on sequence and perform 
sign-on initialization for configuration 
records, subconsole, and other 
miscellaneous functions. 

#MSJO. 4.5.1 #MSJO Job queue IPL setup Initialize job queue file during IPL. 

#MSNIP 11 MSNIPMNT ~~ Main storage IPL phase 1 Start main storage IPL by setting up 
initialization data areas. 

#MSREL Main storage IPL from diskette Transfer system library from diskette to 

disk. 

Notes: 

1. #MSNIP begins execution in the 
system transient area but does a 
translated transfer to itself in order 
to run translated. 

2. #MSREL is link-edited to #MSNIP 
as a routine. 

#MSPR 8.23.2.1 #MSPR Security IPL initialization Control security. 

processor 
#MSRR 8.23.2.1 #MSRR Resource security IPL Do the following at IPL: 
nateREen e Perform resource security checking. 
e Attempt to correct any resource 
security status errors. 
« Sets up resource record in SCA. 

#MSSC 2.1 #MSSC IPL command processor mainline Route control to appropriate command 
processor routine and wait for more 
work to do during IPL. 

#MSSP 4.5.1 #MSSP Spool IPL initialization Allocate, deallocate, reformat or audit 
spool file. Start spool writers for 
autowriter. 

#MSTRC 1.1.3 H#MSTRC IPL trace reset procedure Initialize the microcode trace function. 

#MSTWA 1.1.2 MSTWAMNT Main storage IPL phase 2 Initialization configuration record for 

resident communications and local and remote 
terminals. 

#HOLAF — AFAOOO Build auto-link segment list Read $WORK and rewrite to it any 
R-dots found there. 

#OLAH — OLAHOO Build cross-reference segment Build the cross-reference segment list. 
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Module Chart 
Name Number Entry Point Descriptive Name Function 


HOLAJ — AJAOOO Sort segment list into full Sort segment list into sublists. 
overlay candidate structure 


HOLAP — OLAPOO Overlay design | Use the segment list as generated by 
previous phases in calculating the core 
requirements of a given object program. 


HOLAR — OLAROO Overlay design II Build the overlay segment list. 
HOLAT — ATOOO Overlay linkage editor core MAP Print core usage MAP and error 
phase messages on the printer. 
HOLBE — START Relocate, resolve externs and Read the segment list, and build an ESL 
build load module table, and read the R-modules for each 
overlay, relocate them, and resolve 
externs. 
#OLBO — OLBOOO Overlay linkage editor library Determine type of output requested, and 
control phase call the proper phase. 
#OLDSF — DSFOOO Overlay linkage editor diagnosed Add OLE sysprint messages on the end 
source file of the diagnosed source file (DSF). 
#OLER — EROOO Overlay linkage editor error Call SYSLOG to issue a message. 
routine 
HOLINK — INKOOO Overlay linkage editor user Perform initial processing of user 
interface phase requests for the overlay linkage editor. 
#OLI1 — INK105 Overlay linkage editor user entry Accept // PHASE and // OPTIONS 
phase 2 control statements, syntax check the 
statements, and save the information in 
LOMMON. 
HOLI2 — INK105 Overlay linkage editor user entry Accept // MODULE statements from 
phase 3 SYSIN, find the module(s), and copy 
them to $WORK. 
OLI3 _— INKOOO Overlay linkage editor user entry Accept // EQUATE, // CATEGORY, 
phase 4 and // GROUP statements from SYSIN 


and build segment entries in the 
$SOURCE buffer. 


#OLMSG — OLMSGO Error message print phase Issue error messages for errors detected 
by other phases of the linkage editor. 


HOLYNX — YNX000 Overlay linkage editor compiler _ Initialize for overlay linkage editor. 
entry phase 


4-58 
This document contains restricted materials of IBM. LY21-0590-4 
©Copyright IBM Corp. 1983, 1984, 1985, 1986 


Module Chart 


Name Number Entry Point Descriptive Name Function 

#OPCPD 7.8 START OLPD communications test Set up for control storage 
communications tests and route control. 

OPETY 7.8 START OLPD remote work station entry Get line number for logical work station 
ID passed. 

#OPFCH 7.8 START OLPD configuration fetch Using communications line data 


configuration data in LDA, build index 
into ‘next’ field of control record. 


HOPFWA 7.8 START OLPD WSWA configuration find Get work station communications 
configuration data from WSWA and 
place the data in the LDA. 


#OPMOS 7.8 START OLPD MLCA/SLCA Determine communications adapter type 
determination installed. 
#OPSP 7.8 START OLPD driver Perform mainline routing for OLPD data 


retrieval modules. 


HOPVOF 7.8 START OLPD vary off successful check Check to determine if previously issued 
Vary-Off command was successful. 


HOPVON 7.8 START OLPD vary on successful check Check to determine if previously issued 
Vary-On command was successful. 


HOPWIF 7.8 START OLPD work station information Get and display work station 
configuration data. 


#PDAB 9.7 #PDAB SDLC station test abnormal Terminate SDLC station list. 
termination processor 


#PRBND 8.23.2.8 #PRBND Security bind processor Check that remote location name passed 
by APPC subsystem is authorized for 
System/36 access. 


#PRCG 8.23.2.2 X’ 1000’ Change user profile Change any or all default user menu, 
default user library, and default help 
menu fields in a user profile based on 
the parameter list supplied. 
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Module Chart 
Name Number Entry Point Descriptive Name Function 
#PRERR 8.23.1.2 #PRERR Security error processor Called by various security utilities to 
8.23.1.5 return to mainline code on abnormal 
8.23.1.6 terminations. 
8.23.1.8 
8.23.1.10 
8.23.1.11 
8.23.1.12 
8.23.1.13 
8.23.1.14 
8.23.1.15 
#PRSD 8.23.2.3 #PRSD Password security processor Retrieve user’s security file and make 
sign-on security check. 
#PSBG 10.7.5 #PSBG BSC presentation services get Decompress a buffer received from the 
10.7.7 host into a print, punch, or console 
Output buffer, if requested. 
#PSBP 10.7.4 #PSBP BSC presentation of services Compress an input line of data, either 
put console or reader, put it in a BSCA 
buffer for transmission. 
#PSSG 10.7.5 #PSSG Presentation service get module Decompress input records with support 
10.7.7 SCS characters being processed. 
10.8.7 
#PSSP 10.7.4 #PSSP Presentation services put routine Block input records into output records. 
#RDDFF — #RDDFF Distributed disk file facility Perform System/36 disk data 
management function requested by a 
System/34 source DDFF. (This module 
is evoked through the System/36 
SSP-ICF Peer subsystem and includes 
no System/34 user interface.) 
#RDSA 4.11.4 #RDSA Source DDM allocate Allocate a remote file. 
#RDSC 4.11.4 #RDSC Source DDM close Close a remote file. 
#RDSD 4.11.7 #RDSD Source DDM delete Delete a remote file. 
#RDSE 4.11.5 #RDSE Source DDM error handler Process for errors detected in source 
DDM modules; also process abnormal 
SSP-ICF return codes for the RDICFDM 
procedure used by SDDM components. 
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Module 
Name 


#RDSG 


#RDSO 


#RDSP 


#RDSQ 


#RDSU 


#RDSX 


#RDSZ 


#RDTA 


#RDTC 


#RDTD 


#RDTM 


#RDTO 


Chart 
Number 


4.11.4 


4.11.4 


4.11.4 


4.11.2 


4.11.1 


4.11.5 


4.11.10 


4.11.10 


4.11.6 


4.11.10 


4.11.10 


Entry Point 


#RDSG 


#RDSO 


#RDSP 


#RDSO 


#RDSU 


#RDSX 


#RDSZ 


#RDTA 


#RDTC 


#RDTD 


#RDTM 


#RDTO 


Descriptive Name 


Source DDM get request 
processor 


Source DDM open processor 


Source DDM put request 


processor 


DDM source RENOQ/RDEQ 


DDM suspend 


DDM extract 


DDM release 


Target DDM allocate 


Target DDM close 


Target DDM delete 


Target DDM mainline 


Target DDM open processor 
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Function 


Map disk data management get DTF into 
DDM request and send to remote target 
system. Process response from target 
system and post results to requester. 


Process disk data management open 
request for a remote data file. 


Map disk data management put DTF into 
DDM request and send to remote target 
system. Process response from target 
system and post results to requester. 


Enqueue or dequeue the remote file 
locally, and transmit equivalent request 
to remote system's target DDM. 


Perform initiator processing for remote 
files owned by a JCB that is being 
suspended by the initiator to give control 
to a NRT or MRT program's JCB. 


Search NRD for file label specified by 
VTOC access. Process file format 1 as 
specified by caller of VTOC access. 


Perform termination processing for 
remote files by releasing unneeded ICF 
sessions and dequeueing, freeing, and 
unlocking nonshared remote files. 


Process an allocate request from a 
remote system’s SDDM. 


Process a close request from a remote 
system’s SDDM. 


Process a delete request from a remote 
system's SDDM. 


Perform mainline processing for requests 
received from the remote system’s 
SDDM. 


Process disk data management open 


request for a local file received from a 
remote system. 
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Name Number Entry Point Descriptive Name Function 

#RDTQ 4.11.10 #RDTQ DDM target RENOQ/RDEQ Process enqueue or dequeue request 
received from remote system. 

#RDTT 4.11.10 #RDTT DDM TDDM relay Relay file request to next remote system 
if file is not at this target location. If 
next target system finds file, relay 
request response back to original 
requester. 

#RDTX 4.11.10 #RDTX DDM TDDM extract Process file requests from remote 
system's source DDM extract. 

#RJIBP 10.3.1 #RJIBP MSRJE BSC protocol module Assign space for an MBB and two IOBs, 
and allocate the communications line if 
there is not another BSC MSRJE LOC 
enabled. 

#RJBS 10.7.2 MSRJE BSC subsystem Perform BSC protocol subsystem 
functions. 

#RIBT — #RIBT BSC error termination exit Process BSC subsystem abnormal 

processor terminations. 

#RJCS 10.7.5 #RJCS Forms control table search Search the control table for a carriage or 

10.7.7 routine file build entry whose forms name 
matches the host forms name given in 
the search parameter list. 

#RICTU 10.7.6 RJTABLE Forms control table utility Build an indexed file containing forms 
control information and disk file creation 
information. 

#RJIFILE 10.7.7 #RJIFILE Remote job disk file utility Perform MSRJE disk file processing. 

#RJIE 10.7.1 #RIJIE MSRJE BSC interrupt handler Process every MBB on the MBB queue. 

error processor 

#RJII 10.7.1 #RJII MSRJE BSC interrupt handler Enable BSC adapter. 

link initiate 

#RJIM 10.7.1 #RJIM MSRJE BSC interrupt handler Perform input for and handle output 

mainline from the BSC adapter. 

#RJIT 10.7.1 #RIJIIT MSRJE BSC interrupt handler Disable BSC adapter. 

link termination 

#RIMSG 10.7.4 #RIMSG MSRJE message processor Display messages for MSRJE utility or 
subsystems and return operator reply 
when requested. 

#RJOI 10.7.5 #RJOI MSRJE output task initialize Perform initial setup for MSRJE output 
task mainline. 
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Module Chart 


Name Number Entry Point Descriptive Name Function 

#RJOM 10.7.5 #RJOM MSRJE output task mainline Perform MSRJE printer/punch functions. 

#RJOT 10.7.5 #RJOT MSRJE output task termination Perform abnormal termination for 
processor MSRJE printer/ punch. 

#RJIRC 10.7.4 #RJIRCSTRT §MSRJE reader/console Interpret MSRJE utility control 
command processor commands. 

#RJRI 10.7.4 #RIRINIT MSRJE reader/console initiation Perform reader and console initiation. 

#RIRK 10.7.4 RJRKSTRT MSRJE reader/console close Close and deallocate a file/library 
processor member. 

#RJRL 10.7.4 RJRLSTRT MSRJE reader/console library Process LIBRARY statement. 


statement processor 


#RJIRM 10.7.4 #RJRMAIN MSRJE reader/console mainline Acquire reader sessions to ICF as 
necessary, process MSRJE commands, 
and terminate MSRJE reader/console 
when requested. 


#RIRN 10.7.4 #RIRINIT MSRJE reader/console initiation Initialize data areas and transfer to 
setup initiation. 

#RJRR 10.7.4 RJRRSTRT MSRJE reader/console readfile Process READFILE statement. 
processor 

#RJIRT 10.7.4 #RJIRTERM MSRJE reader/console Terminate MSRJE either normally or 
termination processor abnormally. 

#RIRX 10.7.4 #RIRX MSRJE reader/console syntax — Load and branch to the syntax checker, 
checker and syntax check MSRJE commands. 

#RJISBC — ‘1000’ X MSRJE SNA bind check Check bind images received from 


C/SNA and report acceptability. 


#RISET — *1000'X Perform abnormal termination of Perform abnormal termination function. 
the MSRJE SNA subsystem 


#RJISNA 10.7.3 MSRJE SNA ICF subsystem Perform interface functions between 
MSRJE device drivers and C/SNA. 
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Module 
Name 


#RISXT 


#RJTA 


#RJTB 


#RITF 


#RPDD 


#RPSPD 


#RRA1 


#RRA2 


#RRA3 


#RRA4 


#RWAB 
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Chart 
Number 


10.3.1 


Entry Point 


RJSLSAX 
RJSLSIX 
RJSLUCX 
RJSLTPX 
RJSLSRX 
RJSLSSX 
RJSLERX 
RJSLESX 
RJSINLX 
RJSABDX 
RJSENDX 
RJSCANX 
RJSINAX 


#RJITA 


#RJTB 


#RJITF 


#RPDD 


BEGIN 


1000 


X' 1000’ 


X'0000' 


X'0000' 


#RWAB 


Descriptive Name 


MSRJE SNA SSP-ICF 
subsystem 


MSRJE SNA protocol processor 


MSRJE control block and buffer 
free 


Forms set change processor 


Data dictionary existence test 


Spool queue print file delete 


Resource security check #1 


Resource security check #2 


Resource security check #3 


Resource security check #4 


Remote work station abnormal 
termination 


Function 


Perform non-critical path interface 
functions between MSRJE subsystem 
and C/SNA. 


Assign and initialize the control blocks 
and line buffer for a current location 
during enable. 


Free all control blocks assigned at enable 
time. 


Process forms set manipulation requests. 


Determine if data dictionary named in 
LDA exists; place response in LDA. 
Called by RPG and COBOL procedures. 


Delete the compiler listing that was held 
as a print file on the spool queue by the 
RPGONL, FORTC or COBONL procedure. 


Check user for authorization to use a file 
or library. 


Check user authorization to attach to a 
task that may already have secure 
resources allocated to it. 


Check user authorization to rename a 
file. 


Check user for authorization to use a 
folder member. 


Process a remote work station processor 
check or 2K-page failure within the 
remote work station task or SDLC. 
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Module Chart 
Name Number Entry Point Descriptive Name Function 
#RWAS 9.6.1 RWS mainline task Perform data management processing. 
9.6.2.1 
9.6.2.2 
9.6.2.3 
9.6.3 
9.6.4 
#RWCS RWS send DFC commands 
#RWMG RWS message handler 
#RWPR RWS printer PUT 
#RWSC RWS session control 
#RWSS RWS SNA SSCP-LU flow 
processor 
#RWSV Save screen on disk 
#RWTS RWS SNA 
#RWDD 9.6.2.1 RWS read data to disk Write WSQS overflow data from display 
screen to disk. 
#RWDL 9.6.1 #RWDL Remote work station controller Issue and process all commands 
download processor required to download 5294 Control Unit. 
#RWER 9.6.4 RWS data flow control (DFC) Process SNA DFC commands on 
command handler LU-to-LU flow. 
#RWLK 9.6.4 RWS SDLC error handler Process all error IOBs except open 
station, disconnect, and terminate. 
#RWNR 9.6.2.3 RWS negative response handler 
9.6.4 
#RWRL 9.6.1 #RWRL Remote work station downline Get patch table data for #RWDL and 
loader patch table search verify appropriate system type and code 
level. 
#RWVF 9.6.3 RWS initialization /termination 
9.6.4 
#RWVO 9.6.1 RWS initialization 
9.6.4 
HRWVY 9.6.1 Process vary command 
9.6.3 
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Module Chart 


Name Number Entry Point Descriptive Name Function 
#SBAT 10.6.8 #SBAT Abnormal termination exit Process after serious Finance subsystem 
errors. 
#SBDE — #SBDE Data encryption/decryption Encrypt or decrypt user data for Finance 
subroutine subsystem. 
#SBFS 10.6.8 SBACxxxx Finance subsystem Interface between all System /36 


functions and the Finance subsystem. 


#SBIT — #SBIT Diskette image transfer transient Send diskette image to a 3601 
communications controller. 


#SBOP 10.3.1 #SBOP SDLC line and task open routine Perform enable-time processing or open 
functions for the subsystem. Allocate 
and initialize resources. 


#SDAM 9.2.4 #SDAM Abnormal termination for Perform initial abnormal termination for 
mainline errors detected by SDLC mainline. Route 
terminate/detach IOB to #SDAT. 


#SDAT 9.2.4 #SDAT Abnormal termination for Perform initial abnormal termination for 
initialization / termination errors detected by SDLC initialization or 

termination, and perform abnormal 

termination for all SDLC processes. 


#SDIT 9.2.1.1 SDLC initialization /termination Process line open requests from SNA, 
9.2.1.2 task handle open station and enable IOBs 
from the SNA, process all messages for 
SDLC, and complete processing for 
terminate/detach from SDLC. 


#SDLC 9.2.2.2 Mainline SDLC subtask 
9.2.1.1 
9.2.1.2 
#SDRI 9.2.3 SNA-to-DLC interface loader Assign an area of SQS and load the 
9.10.1.1 resident interface program. (The resident 
9.10.1.2 interface processes all IOBs from SNA 
for SDLC, X.25, or LAN.) 

#SIVD 4.11.1 #SIVD DDM NRD access Get network resources directory (NRD) 
entry from #NRD.FLE file for requested 
remote file. 
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Module 


Name 


#SPALC 


#SPATW 


#SPCLO 


#SPDBR 


#SPINT 


#SPMIC 


#SPQMG 


#SPRT 


#SPWDB 


#SPWRT 


#STLOAD 


#STO1 


#STO2 


#STO3 


Chart 
Number 


4.5.2 


4.5.1 
4.5.2 


4.5.2 


4.5.3 


4.5.2 


4.5.2 
4.5.3 


4.5.2 
4.5.3 


4.5.2 
4.3.1 


4.5.1 


Entry Point 


#SPALC 


#SPATW 


#SPCLO 


#SPDBR 


#SPINT 


#SPMIC 


#SPQMG 


PRT#DPDM 


PRTSPINT 


#SPWDB 


#SPWRT 


#STLOAD 


S$START 


$START 


$START 


Descriptive Name 


Spool allocate 


Spool writer attach 


Spool intercept close 


Spool writer data blanker 


Spool intercept 


Spool message handler 


Queue manager 


Spool/printer data management 
router resident 


Writer descriptor block (WDB) 
builder 


Spool writer 


SYSTEST loader 


Test request main storage 
verification program 


Test request display verification 
program 


Test request printer verification 
program 
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Function 


Allocate spool intercept control blocks 
and spool file segments. 


Attach spool writer. 


Complete the intercepting of a print file 
so it is no longer associated with the 
creating task. 


Blank ideographic spool print data. 


Intercept the print data (included in 
#DPDM). 


Handle spool intercept and spool writer 
messages. 


Spool queue management. 


If possible, process print request; 
otherwise, set up parameter list mapping 
for #DPDM, to simplify transfer SVC 
instruction to/from printer data 
management. 


Set up registers for implicit mapping to 
DTF and user buffer for transfer to 
#DPDM 


Set up registers for implicit mapping to 
the intercept buffer when spool intercept 
transfers to #DPDM. 


Build writer descriptor block (WDB) for 
spool. 


Print entries from the spool file. 


Load programs from the diagnostic 
diskette into main storage to run under 
the SSP. 


Prompt operator for test request options: 
display verification, printer verification, 
configuration data, ERAP, or link test. 
Route control based on option selected. 


Prompt for display verification options 
and execute test selected. 


Prompt for printer verification options 
and execute test selected. 
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Module Chart 


Name Number Entry Point Descriptive Name Function 
#STO4 7.6 $START Test request configuration Display configuration data for online 
verification program local and remote work stations (excludes 


native-attach printers). 


HSVAT 6.2.11 HSVAT Task Attach/Reorg/Detach Allocate necessary resources to attach a 
6.2.12 new task to the system. Change task 
ORG point when task execution passes 
SSP to user, or when the task is to be 
detached. On EOJ, free all task 
resources. 


#SVDMP 6.2.15 #SVDMP Snap dump transient Snap dump storage within limits or snap 
dump entire region. 


#SVEJR 4.5.3 #SVEJR EOJ purge of console queue for Check the console SYSLOG queue and 
|/O messages the console matrix looking for any |/O 
messages associated with the task being 
canceled. 


#SVERP 2.5 #SVERP Error processing transient Allow |/O devices other than the work 
2.13 Stations to issue error messages to the 
system console. Route control for |/O 

error recovery transient. 


#SVESP 2.14 #SVESP Display station error router Allow display station error messages to 
be sent to the system console. Route 
control for display station errors. 


#SVINF 6.2.14 #SVINF Information retrieval transient Support the SINFO macro. 


#SVML 2.14 #SVML Error task mainline Initialize 1/O device error processing 
whenever an error post is received. 


#SVNRY 2.13 #SVNRY Display station error recovery for Attempt recovery from operator error 
device not ready mode command reject exceptions. 
#SVQLK — #SVQLK Quick lock/release resident Interlock or release the specified system 
resource. 
#SVRD 2.13 #SVRD Command reject ready routine Retrieve command rejected records from 


a work station command reject file. 


#SVTS 4.5.3 #SVTS System time stamp Place a time stamp in the history file and 
calculate elapsed time. 


#SVTUB 1.1.2 SVTUBMNT ~— TUB build transient Allocate and initialize work station work 
area (WSWA) and initialize TUB for the 
device being varied on. 


H#SVTX — #SVTX Task work area extension Provide recovery when the TWA runs 
transient out. 
#SVWER 2.13 #SVWER |/O error message handler Allow 1/O devices to issue error 


messages to the system console. 
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Module Chart 
Name Number ~~ Entry Point Descriptive Name Function 
#SVWSR 2.5 #SVWSR Display station error recovery Attempt recovery from: hardware 
2.11 malfunctions, software errors, command 
2.13 reject exceptions, and process 
2.15 not-ready-to-ready post. 
#TACLO 5.1.1 #TACLO Tape data management close Rewind or unload tape on close. 
#TAADD 4.8 #TAADD Tape data management add Perform tape data management add 
function. 
#TAEOV 4.8 #TAEOV Tape data management end of Perform tape data management 
volume end-of-volume processing. 
#TAFND 4.8 #TAFND Tape data management find Perform tape data management find 
function. 
#TAGET 4.8 #TAGET Tape data management get Perform tape data management get 
function. 
#TAOPN 3.3.1 #TAOPN Tape data management open On open, build tape IOB and set up 
physical buffer. 
#TAPUT 4.8 #TAPUT Tape data management put Perform tape data management put 
function. 
#TARBK 4.8 #TARBK Tape read block data Read a full or partial block of data from 
management the hardware buffer into the physical 
buffer. 
#TAWBK 4.8 #TARBK Tape write block data Write a full or partial block of data to 
management tape from the physical buffer. 
#TMALST 8.35 #TMALST FMS archive list module Read a save file (archived member file) 
from diskette or tape and list the 
information on the SYSLIST device. 
#TMARC 8.35 #TMARC FMS archive member Copy member(s) of a folder to a file on 
diskette or tape. If specified, delete 
member after archiving. 
#TMBDA 4.10.4 #TMBDA FMS build DTA extent Build a DTA extent for the specified 
folder. 
#TMBLD 1.1.7 #TMBLD IPL FMS folder rebuild Determine which folder must be rebuilt 
and call #TMRBD for each one. 
#TMCLS 4.10.3 #TMCLS FMS close member and library Close folder or folder member(s). 
#TMCPY 4.10.4 #TMCPY FMS copy member Copy a member from a folder to the 
same or another folder, creating a new 
or replacing an existing member. 
#TMCRT 4.10.4 #TMCRT FMS create folder Create a new folder. 
#TMDAR 4.10.3 #TMDAR FMS delete associate records Delete one, several, or all of the 
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Module Chart 

Name Number Entry Point Descriptive Name Function 

#TMDT 4.10.3 #TMDT FMS delete folder Delete some or all of the folder stream 
in a member. 

#TMFAC 8.35 #TMFAC FMS archive member Copy a folder member to a disk file. 

#TMFD 8.35 #TMFD FMS save folder Save a folder to a disk file. 

#T MFI 8.35 #T MFI FMS restore folder Restore a folder from a disk file. 

#TMFRT 8.35 #TMEFRT FMS retrieve member Retrieve a folder member from a disk file. 

#TMGAR 4.10.3 #TMGAR FMS get associate records Get associate record (miscellaneous 
folder information) from a folder. 

#TMGDD 4.10.3 #TMGDD FMS get data descriptors Retrieve one or more DDA fields. 

module 

#TMGIT 4.10.3 #TMGIT FMS get folder information Get information about the folder units in 
a member. 

#TMGT 4.10.3 #TMGT FMS get folder Get folder units (DW /36-folder-stream 
format) for a member in a folder. 

#TMIO 4.10.3 #TMIO FMS |/O router Route for specialized FMS |/O modules. 

#TMIPL 1.1.4 #TMIPL FMS IPL initialization Create FMS system work spaces. 

#TMLDD 4.10.3 #TMLDD FMS list data descriptors List one or more DDA fields. 

module 

#TMLST 4.10.4 #TMLST FMS list folder List information about a folder or group 
of folders. 

#TMMDT 4.10.4 #TMMDT FMS delete member Delete a member, delete the text portion 
of a member, or delete a member 
without deleting its entries in the 
physical directory. 

#TMMRN 4.10.4 #TMMRN FMS member rename Rename a member within a folder. 

#TMMV 8.35 #TMMV FMS move folder Move folder from one location to 
another on disk. 

#TMOPN 4.10.3 #TMOPN FMS open member and folder Open requested member and folder. 

module 

#TMPAR 4.10.3 #TMPAR FMS put associate record Put an associate record to a member in 
a folder. 

#TMPDD 4.10.3 #TMPDD FMS put data descriptors Put data descriptors or a folder 
description to the DDA portion of a 
folder. 

#TMPT 4.10.3 #TMPT FMS put folder Put DW/36 folder stream to a member 
in a folder. 
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Module Chart 

Name Number Entry Point Descriptive Name Function 

#TMRAR 4.10.3 #TMRAR FMS read associate record Read an associate record (no previous 
file open required). 

#TMRBD 1.1.7 #TMRBD FMS folder rebuild Rebuild folders. 

#TMRORG 8.35 #TMRORG FMS reorganize folder module Reorganize a folder removing as much 
unused space as possible and optionally 
changing its size. 

#TMRS 8.35 #TMRS FMS restore folder module Restore a folder from a diskette or 
tape file. 

#TMRTV 8.35 #TMRTV FMS retrieve archived member _ Retrieve an archived folder member from 
a diskette or tape file. 

#TMSDD 4.10.3 #TMSDD FMS search data descriptors Search one or more DDAs against 
search argument passed in parameter 
list. 

#TMSMD 4.10.3 #TMSMD FMS search additional data Retrieve search information collected on 

descriptors module a previous search. 

#TMSR 1.1.7 TMSOO0000 FMS common subroutines Process subroutine calls for common 

4.10.3 FMS functions. 
#TMSV 8.35 #TMSV FMS save folder Save folder(s) to a diskette or tape file. 
4.10.4 

#TMTRM 5.2.1 #TMTRM FMS termination Perform FMS task termination: dequeue 
DSC buffer, deallocate partially allocated 
DTAs, back-out changes to partially 
renamed member, unlock FMS 
resources, close folders and members, 
delete partial members, and dequeue 
and free FMS control blocks. 

#TMXT 4.10.3 #TMXT FMS extend data descriptor area Build replacement DDA with additional 
space in areas specified by caller. 

#TPMA 4.10.2 #TFMA Office systems profiles Perform user-specified operations on an 

processor office systems profile or profile folder: 
open profile and profile member, get, 
put, or delete component subprofile, 
close profile member and folder, and 
translate MIC to profile services return 
code. 

HTTAC 4.10.1 #TTAC DW/36 format to alternative Convert input DW/36 text stream to 


character set processor 
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for printing. 
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Module Chart 

Name Number Entry Point Descriptive Name Function 

#TTBS 4.10.1 #TTBS FFT-DCA to 5219 Printer format Convert FFT-DCA data stream to 
processor FFT-DCA output stream for printing on 

the 5219 Printer. 

#TTBW 4.10.1 #TTBW Transmit WP-EBCDIC data Send WP-EBCDIC data stream to 6670 
stream Printer via batch BSC. 

#TTCA — #TTCA Release 1 and 2 text format to Put up screen to prompt for conversion 
DW/36 format conversion aid aid requests. 

#TTCD — #TTCD Release 1 and 2 text format to Put up screen to prompt for document 
DW /36 format conversion aid conversion. 

#TTCJ — #TTCJ Release 1 and 2 text format to Initialize to run conversion on job queue 
DW //36 format conversion aid _job. 

#TTCV — #TTCV Release 1 and 2 text format to Convert release 1 and 2 document to 
DW //36 format conversion aid DW/36 document. 

#TTGR 4.10.1 #TTGR Source to DW/36 format Convert input stream source and 
processor procedure members to DW/36 text 

format for internal (utility) processing. 

#TTIM 4.10.1 #TTIM FFT-DCA to DW/36 format Convert FFT-DCA input stream source 
processor to DW/36 text format for internal (utility) 

processing. 

#TTJM 4.10.1 #TTJM DW/36 format to FFT-DCA Convert input DW/36 text stream to 
format processor FFT-DCA-format output stream for 

transmission to another system or 
printing on the 5219 Printer. 

#TTKR 4.10.1 #TTKR RFT-DCA to DW/36 format Convert RFT-DCA input stream source 
processor to DW/36 text format for internal (utility) 

processing. 

#TTLR 4.10.1 #TTLR DW/36 format to RFT-DCA Convert input DW/36 text stream to 
format processor RFT-DCA-format output stream for 

transmission to another system. 

#TTPP 4.10.1 #TTPP Release 1 and 2 text paragraph Convert input text paragraph to DW/36 
to DW/36 paragraph conversion folder paragraph for internal (utility) 
processor processing. 

#TTPR 4.10.1 #TTPR Release 1 and 2 text format to Convert input text stream to DW/36 
DW/36 format conversion folder format for internal (utility) 
processor processing. 

#TTRT 4.10.1 #TTRT Office systems transforms root Initialize for office systems text format 
phase 1 transformation. 
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Module 
Name 


#TTR1 


#TTSA 
#TTSS 
#TTWP 


HUSYX 


#WDDA 
#WDDB 


#WDDC 


#WDDG 


#WDDH 


#WDDK 


#WDDL 


Chart 
Number 


4.10.1 


4.10.1 


4.10.1 


4.10.1 


6.2.13 


4.4.1 


4.4.1 


4.4.2 


4.4.1 


4.4.2 


4.4.2 


4.4.2 


Entry Point 


#TTR1 


#TTSA 


#TTSS 


#TTWP 


#USYX 


#WDDA 


#WDDB 


#WDDC 


#WDDG 


#W DDH 


#WDDK 


#WDDL 


Descriptive Name 


Office systems transforms root 
phase 2 


DW//36 format to SCS#1 format 
processor 


DW //36 format to SCS#2 format 
processor 


DW /36 format to WP/EBCDIC 
format processor 


Syntax checker 


Work station data management 


Work station data management 


Print op modifier 


Work station data management 
GET routine 


Work station data management 
routines 


Work station data management 
routines 


Work station data management 
translated routine 
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Function 


Route for requested office systems text 
format transformation. 


Convert input DW/36 text stream to 
SCS#1 format output stream for printing 
on the 4214, 5224, or 5225 Printer. 


Convert input DW/36 text stream to 
SCS#2 format output stream for printing 
on the 3262 or 5256 Printer. 


Convert input DW/36 text stream to 
WP/EBCDIC output stream for printing 
on the IBM 6670 Information Distributor. 


Scan input records, using appropriate 
syntax specification module, to verify 
statement syntax and to collect, convert, 
and substitute statement elements. 


Note: Although this module has only 
one entry point, parameter list controls 
enable a caller to select syntax checking 
functions as if there were two entry 
points. 


Resident version of work station data 
management. Put logic. 


Miscellaneous subroutines for work 
station data management. 


Transient handles print op modifier. 


Handle status inquiry, invite terminal 
input, accept terminal input, get terminal 
input, and release terminal from program 
functions. 


Handle process requests for Help and 
Print keys, key masking functions, and 
issue messages for Print key request 
functions. 


Process requests for the Print key. 


Process requests for two read 
operations. 
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Module Chart 
Name Number Entry Point Descriptive Name Function 
#WDDP 4.4.2 #WDDP Work station data management Print key task. 
Print key routine 
#WDDQ 4.4.1 #WDDQ Work station data management Handle acquire terminal, get terminal 
4.4.2 GET routine attribute functions, issue WSDM 
SYSLOG halts, stop invite, and retrieve 
MICs for formats. 
#WDHH — #WDHH Work station data management Process high level requests for the Help 
routine key. 
#WDIGC 4.4.1 #WDIGC Work station data management Scans data stream for IGC data. 
4.4.2 IGC support 
#WDOPN 3.3.1 #WDOPN Work station open routine Open work station DTFs passed by 
common open. 
#WDRK — #WDRK Roll keys reversal Assigns direction of roll-up and roll-down 
keys (evoked by ROLLKEYS procedure). 
#WPAS 9.9.1 #WPAS Display station pass-through 
source abnormal termination 
#WPAT 9.9.2 H#WPAT Display station pass-through 
target abnormal termination 
#WPER 9.9.2 #WPER Display station pass-through Perform display station pass-through 
error mapping error mapping for System/38 attached 
displays. 
#WPIN 9.9.1 #WPIN Display station pass-through Perform initial processing for display 
source initialization Station pass-through source. 
#WPSI 9.9.2 #WPSI Display station pass-through 
stop outstanding invites 
#WPTS 9.9.1 #WPTS Display station pass-through Display station pass-through source 
source program mainline processing 
#WPTT 9.9.2 #WPTT Display station pass-through Display station pass-through target 
target program mainline processing 
HWPVY 9.9.2 #WPVY Display station pass-through 
vary on transient 
#XTAT 9.8.3 HXTAT X.25 abnormal termination Perform mainline processing for X.25 
mainline abnormal termination. 
#XTEH 9.8.2 #XTEH X.25 error handler Process virtual circuit, link, and hardware 
errors. 
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Module Chart 

Name Number Entry Point Descriptive Name Function 

#XTIT 9.8.1 #XTIT X.25 initialization termination Perform mainline processing for 

task initialization and termination of X.25 
tasks. 

#XTML 9.8.2 #XTLM X.25 mainline task Perform mainline functions for X.25 
transmit and receive operations. 

@BSCC — @BSCC BSC translate module Translate ASCII to EBCDIC or EBCDIC 
to ASCII. 

@GSCA7 — @GSC70 Decimal to binary conversion Convert columns 13 through 16 of the 
card work area to binary. 

@GSCAQ9 — @GSCA9 Calculate length Operate on the current card in the 
39-byte work area. 

@GSEG — @GSEGO Automatic work file allocation Allocate work file space and build the 

routine entries in the MVF table in COMMON. 

@GSZB — #GSZBO Decimal to hex conversion Convert an unsigned 7-byte zoned 
decimal number to a 3-byte hex number. 

@GSZC — #GSZCO Hex to zone decimal conversion Convert a 3-byte hex number to a byte 
decimal number and concatenate a sign 
to the result. 

@GSZD — #GSZDO 4-byte hex divide routine Devide two hex numbers in own work 
area and upon exit, put the quotient and 
the remainder in the user's areas. 

@GSZE — #GSZEO Bitohex Convert 4-bit groups to their EBCDIC 
equivalent. 

@GSZF — #GSZFO Bit to bit Convert 1 byte of memory to printable 
graphics, 1 bit at a time. 

@GSZM — #GSZMO 4-byte hex multiply routine Multiply two hex numbers in own work 
areas and upon exit, put result in user’s 
product area. 

@PRLD 8.23.2.1 X‘5000° Security reload check subroutine Checks security is password security is 
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active. 


Section 4: Directory 4-75 


Module 
Name 


@PRUDM 


@RRDMT 


IPTR 


SUBRSF 


SUBR30 


SUBR31 


4-76 


Chart 
Number 


8.23.1.1 
8.23.1.2 
8.23.1.3 
8.23.1.4 
8.23.1.5 
8.23.1.6 
8.23.1.10 
8.23.1.11 
8.23.1.12 
8.23.1.13 
8.23.1.16 


8.23.1.7 
8.23.1.8 
8.23.1.9 
8.23.1.10 
8.23.1.11 
8.23.1.14 
8.23.1.15 
8.23.1.16 
8.23.2.1 


4.3.1 


Entry Point 


(Varies with 


include 
module) 


(Varies with 


include 
module) 


IPTR 


SUBRSF 


SUBR30O 


SUBR31 


Descriptive Name 


User identification file data 
management routine 


Resource security file data 


management routine 


Printer |/O Supervisor 


RPG Il special SMFLOG file 
access routine 


RPG Il interface to DES 
algorithm 


COBOL interface to DES 
algorithm 


Function 


Perform file access for user identification 
file utilities. 


Perform file access for resource security 
file utilities. 


Route print requests to spool intercept, 
RAM print transient, or SNA task via 
remote printer setup. 


Note: There is no control storage printer 
IOS function. This module interfaces to 
control storage printer IOCH. 


Read variable-length records from the 
SMFLOG data file created by the SMF 
data collection program and convert the 
data to a form usable by an RPG Il 
program. 


Provide the interface between an RPG II 
subroutine parameter list and the input 
data stream required by #SBDE. 


Provide the interface between a COBOL 
subroutine parameter list and the input 
data stream required by #SBDE. 
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Appendix A: Data Communications Line Protocols 


This appendix contains protocol reference information 
that is intended for programming service representatives 
who already know fundamental data communications 
line protocol. It contains representative examples of line 
protocols for various System/36 data communications 
capabilities; these examples are intended to assist the 
PSR in problem solving situations. Included in this 
appendix is normal line protocol information for the 
following: 


e BSC Data Communications Line Protocols 


- Batch and SSP-ICF Figure A-1 
— BSCEL Figure A-2 
— 3270 Figure A-3 
— MSRJE Figure A-4 
e SNA Session Protocols 
— Upline Facility (SNUF) Figure A-5 
— 3270 Figure A-6 
— MSRJE Figure A-7 
— Remote Work Station Figure A-8 
— Finance Figure A-9 
— Peer Figure A-10 
— APPC Figure A-11 
— APPN Figure A-12 
« X.25 Data Communications Figure A-13 


Protocols 


Note: Additional information on all protocols described 
in this appendix is contained in the Data Areas manual. 


BSC DATA COMMUNICATIONS LINE PROTOCOLS 


The data communications line protocols for batch BSC 
and the four SSP-ICF BSC subsystems are included in 
this section. (Because of their similarity, batch and 
SSP-ICF are grouped together.) These line sequences are 
typical of those exchanged between a System/36 and a 
remote system for the various line types and nodes 
labeled. 


Batch and SSP-ICF 


Figure A-1 shows protocols for the following batch BSC 
and SSP-ICF BSC operations: 

— Transmitting: Autocall/Manual Call 

— Transmitting: Autoanswer/Manual Answer 

— Receiving: Autocall/Manual Call 

— Receiving: Autoanswer/ Manual Answer 

— Transmitting: Point-to-Point, Nonswitched Line 
— Receiving: Point-to-Point, Nonswitched Line 

— Transmitting: Multipoint Tributary Line 

— Receiving: Multipoint Tributary Line 

— Transmitting: 3740 Multiple File Support 

— Receiving: 3740 Multiple File Support 

— Transmitting: 3780 Protocol Format 

— Receiving: 3780 Protocol Format 

— Transmitting: OFFICE/36 Device Support 


Appendix A: Data Communications Line Protocols A-1 
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Transmitting: Autocall/Manual Call (Point-to-Point, 
Switched Line) 


Syetor/ 


Initialization 
(ID) ENQ 


(ID) ACKO 


Message data ETB 
Transfer 


Sal? data ETB 


data ETX 
ACKO/ACK1 


Termination 


EOT/DISC 


S0590086-0 
Figure A-1 (Part 1 of 13). Batch and SSP-ICF BSC Data Communications Line Protocols 
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Transmitting: Autoanswer /Manual Answer 
(Point-to-Point, Switched Line) 


System/36 


Initialization 
(ID) ENQ 


(ID) ACKO 


ENQ 


Message data ETB 
Transfer 


State data ETB 


data ETX 
ACKO/ACK1 


Termination EOT/DISC 


$0590087-0 
Figure A-1 (Part 2 of 13). Batch and SSP-ICF BSC Data Communications Line Protocols 
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Receiving: Autocall/Manual Call (Point-to-Point, 
Switched Line) 


system/36 
ee Se ee 


Initialization 
(ID) ENQ 


(ID) ACKO 
EOT 

ENO 
ACKO 


Message data ETB 
Transfer 


tat 
oie data ETB 


data ETX 
ACKO/ACK1 


Termination EOT/DISC 


$0590088-0 
Figure A-1 (Part 3 of 13). Batch and SSP-ICF BSC Data Communications Line Protocols 
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Receiving: Autoanswer /Manual Answer (Point-to-Point, 
Switched Line) 


Initialization 


(ID) ENO 
(ID) ACKO 


Message data ETB 
Transfer 


State data ETB 


data ETX 
ACKO/ACK1 


Termination EOT/DISC 


$0590089-0 
Figure A-1 (Part 4 of 13). Batch and SSP-ICF BSC Data Communications Line Protocols 
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Transmitting (Point-to-Point, Nonswitched Line) 


Initialization 


Message data ETB 
Transfer 


ae data ETB 


data ETX 


ACKO/ACK1 


Termination 


Note: /f ENQs are simultaneously issued by the System/36 and the remote station, contention 
will continue until the remote station sends ACKO or the retry count is exceeded. 


$0590090-1 


Figure A-1 (Part 5 of 13). Batch and SSP-ICF BSC Data Communications Line Protocols 


This document contains restricted materials of IBM. LY21-0590-4 
©Copyright IBM Corp. 1983, 1984, 1985, 1986 


Receiving (Point-to-Point, Nonswitched Line) 


Initialization 


Message data ETB 
Transfer 


State data ETB 


data ETX 


ACKO/ACK1 


Termination 


$0590091-0 
Figure A-1 (Part 6 of 13). Batch and SSP-ICF BSC Data Communications Line Protocols 
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Transmitting (Multipoint Tributary Line) 


System/36 
SSE ea aaa 


Initialization 


Message data ETB 
Transfer 


State 
data ETB 


data ETX 


ACKO/ACK1 


$0590092-0 
Figure A-1 (Part 7 of 13). Batch and SSP-ICF BSC Data Communications Line Protocols 
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Receiving (Multipoint Tributary Line) 


Syston /36 


Initialization 
SELECT 


Message 
Transfer 


State data ETB 


data ETB 


data ETX 


ACKO/ACK1 


Termination 


$0590093-0 
Figure A-1 (Part 8 of 13). Batch and SSP-ICF BSC Data Communications Line Protocols 
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Transmitting (3740 Multiple File Support) 


System/36 


Initialization 


Message data ETB 
Transfer 
State 


(file 1) data ETB 


Null Record STX-ETX 
Ends 


ACKO/ACK1 
(file 1) 


Message data ETB 

Transfer ACK1/ACKO 
State 

(file n) 


Null Record 
Ends 
(file n) 


Termination 


ACKO/ACK1 


$0590095-0 


Figure A-1 (Part 9 of 13). Batch and SSP-ICF BSC Data Communications Line Protocols 
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Receiving (3740 Multiple File Support) 


System/36 


Initialization 


Message data ETB 
Transfer 


State 
(file 1) data ETB 


Null Record STX-ETX 


Ends ACKO/ACK1 
(file 1) 


Message data ETB 
Transfer ACK1/ACKO 


Null Record 
Ends 
(file n) 


Termination 


ACKO/ACK1 


$0590094-0 
Figure A-1 (Part 10 of 13). Batch and SSP-ICF BSC Data Communications Line Protocols 
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Transmitting: 3780 Protocol Format (Blank 
Compression/ Expansion) 


System/36 


Initialization 


Message 
Transfer 
State 


STX-Rec1-!IGS-(n)Rec1-IGS-(n)Rect1 
IRS-Rec2-IGS-(n)-IRS-ETB 


STX-Rec3-IRS-Rec4-!IGS-(n)-IGS- 
(n)Rec4-IRS-Rec5-IRS-ETB 


STX-Rec6-IGS-(n)-IRS-Rec7-IRS- 
Rec8-|IGS-(n)Rec8-IGS-(n)-IRS-ETX 


Termination 


Notes: 


1. The (n) represents the number (1 byte) of compressed blanks. 
The maximum is 63. A hex 40 is always added to the count. 
For example, if 20 (hex 14) blanks are compressed, the count 
(n) is hex (54). 


2. Records cannot span blocks. 
3. Compression cannot be used with transparent output. 


$0590096-0 
Figure A-1 (Part 11 of 13). Batch and SSP-ICF BSC Data Communications Line Protocols 
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Transmitting: 3780 Protocol Format (Blank Truncation) 


System/36 


Initialization 


Message 
Transfer 
State 


STX-Rec1-IRS-Rec2-IRS- 
Rec3-IRS-Rec4-!IRS-ETB 


STX-Rec5-!IRS-Rec6-IRS- 
Rec7-IRS-Rec8-IRS-ETB 


STX-Rec9-!IRS-Rec10-IRS- 
Rec11-IRS-ETX 


Note: The trailing blanks at the end of each record are removed before transmitting the block. 


$0590097-0 
Figure A-1 (Part 12 of 13). Batch and SSP-ICF BSC Data Communications Line Protocols 
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Transmitting: OFFICE /36 Device Support 


This protocol is supported by batch BSC and by the 
SSP-ICF BSCEL subsystem. 


System/36 


Initialization 


Message data ETB 
Transfer 
State-- 


(Document 1) data ETB 


ETX Ends 
(Document 1) 


Message data ETB 
Transfer ACKO/ACK1 


State 


(Document n) data ETB 


ACKO/ACK1 


ETX Ends 
(Document n) 


Termination 


$0590410-0 


Figure A-1 (Part 13 of 13). Batch BSC (and BSCEL Subsystem) Data Communications Line Protocols 
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BSCEL Subsystem Office Product Device Support 


Figure A-2 shows the line activity that takes place 
between the System/36 SSP-ICF BSCEL subsystem and 
the office product device. 


Receiving 


System/36 


Initialization 


Message data ETB 
Transfer 


State-- 
(Document 1) data ETB 


ETX ends 
Document 1 


Message data ETB 


Transfer ACKO/ACK1 
State-- 


(Document n) 


data ETB 
ACKO/ACK1 


ETX ends 
Document n 


Termination 


$0590098-0 
Figure A-2. SSP-ICF BSCEL Subsystem Line Protocols 
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BSC 3270 


The following flow sequences show the line activity that 
takes place between a host system and a System/36 
using BSC 3270 device emulation. 


The four major areas of processing are: 
— Device Initialization at Host 

Inbound Data Processing 

Outbound Data Processing 

Device Termination at Host 


Device Initialization at the Host System, When a Work 
Station Is Powered On (Normal Device Initialization) 


5250 Operator System/36 


Poll 


EM3270 


Device End Status 


EOT 


$0590063-0 
Figure A-3 (Part 1 of 4). BSC 3270 Data Communications Line Protocols 
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Inbound Data Processing (Data Coming to Host from 
System/36) 


5250 Operator System/36 


AID Key pressed 
(such as Enter) 


$0590212-0 
Figure A-3 (Part 2 of 4). BSC 3270 Data Communications Line Protocols 


Outbound Data Processing (Data Sent from Host System 
to System/36) 


5250 Display System/36 


SELECT 
Keyboard locks 


Display updated and 
keyboard unlocked 
(if necessary) 


$0590064-0 
Figure A-3 (Part 3 of 4). BSC 3270 Data Communications Line Protocols 
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Device Termination at the Host System, As a Terminal 
Powering Off (Normal Device Termination) 


5250 Operator System/36 


Poll 
Command key 24 Poll 
| O 
is pressed Intervention 
required status 
ACK 


EOT 


$0590213-0 
Figure A-3 (Part 4 of 4). BSC 3270 Data Communications Line Protocols 
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BSC MSRJE 

Figure A-4 shows protocols for the following BSC 
MSRJE operations: 

— Sign-On 


— Data Transmission 
— Sign-Off 


Sign-On 


System/36 [HostSystem | Comment 


System /36 sends ENQ to establish communication. 


Host system responds with ACKO when ready. 


SIGN-ON Sign-on sequence is sent to the host system. 


Host system receives sign-on and responds with ACKO. 


System/36 sends ACKO because there is no data to 
send to the host system RD1 (see Note 1). 


Host system responds with ACKO because there is 
nothing to send from the host System/36 (see Note 1). 


$0590065-0 
Figure A-4 (Part 1 of 4). BSC MSRJE Data Communications Line Protocols 
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Data Transmission 


System/36 sends ACKO because there is nothing to 
send (see Note 1). 


Host system responds with ACKO because there is 
nothing to send (see Note 1). 


RFT RD1 System/36 sends a request function transmission 
for the host systems reader one (RD1). 


GFT RD1 Host system sends a grant function transmission 
allowing use of the host systems reader 1 (RD1). 


RD1 DATA System/36 sends RD1 data stream to the host system. 


$0590214-0 
Figure A-4 (Part 2 of 4). BSC MSRJE Data Communications Line Protocols 
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Data Transmission 


ACKO Host system responds with ACKO (positive 
acknowledgment) if there is no information to send 
(see Note 2). 


RD1 DATA System/36 sends another text block to RD1. 


Console DATA Host system responds with data transmitted to the 
System/36 console (see Note 2). 
RD1 DATA System /36 responds with another text block for RD1. 


RFT PR1 Host system responds with a request function 
transmission for the System /36 printer 1. 


GFT PR1 System/36 sends a grant function transmission 


for the printer task. 


PR1 DATA Host system sends a printer data stream to the 
System /36. 


RD1 DATA (EOF) System/36 sends a RD1 text block with end of file 


(when EOF is sent, the RD1 task is deactivated). 


PR1 DATA Host system sends another PR1 text block. 


System/36 responds with ACKO because PR1 data has 
has been successfully received and there is no 
more data to send (see Note 1). 


PR1 DATA (EOF) | Host system sends a PR1 text block with end of file. 
This deactivates the printer task. 


System/36 sends ACKO (see Note 1). 


Host system sends ACKO (see Note 1). 


S0590066-1 
Figure A-4 (Part 3 of 4). BSC MSRJE Data Communications Line Protocols 
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Sign-Off 


System/i [Host System ——~=«di Comment —SSOSC—~—S 


é 


RFT RD1 ! System/36 sends a request function transmission 
for the host systems reader 1 (RD1). 


GFT RD1 Host system sends a grant function transmission 
allowing use of RD1. 


LOGOFF / System/36 sends a logoff /signoff sequence, and EOF 
SIGNOFF (EOF) for RD1. 


Host system sends an ACKO. 


Notes: 


1. If there is no information to be transferred, the line connection is maintained by sending and receiving ACKOs. This 
sequence continues until either the host system or System/36 has information to send. 


2. If the host system receives a transmission successfully and has data ready to send, the data transmission is a 
positive acknowledgment (ACKO is not required). 


$0590215-1 


Figure A-4 (Part 4 of 4). BSC MSRJE Data Communications Line Protocols 
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SNA SESSION PROTOCOLS 


This section contains typical line sequences for six SNA subsystems. 


SNA Upline Facility (SNUF) 


Figure A-5 shows protocols for the following SNA Upline Facility (SNUF) operations: 
— Enable 

— Acquire Session 

— Evoke with Invite 

— Release 

— Abnormal End of Session 

— Disable 


Enable 


System/36 


$0590079-0 
Figure A-5 (Part 1 of 7). SNUF Session Protocols 
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Acquire Session (One Communications Line Was Active 
before Acquire Operation) 


NOTIFY 


LOGON 


$0590080-0 
Figure A-5 (Part 2 of 7). SNUF Session Protocols 
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Acquire Session (before Host System Starts the 
Communications Line) 


System/96 


ACTPU 


ACTLU 


$0590081-0 
Figure A-5 (Part 3 of 7). SNUF Session Protocols 
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Evoke with Invite 


System/36 


FMD (BB, BC, EC, CD, RQE) 
FMD (EB, BC, EC, ROD) 
+RSP 


$0590082-0 


Figure A-5 (Part 4 of 7). SNUF Session Protocols 


Release Operation 


Syton/36 


RSHUTD 
+RSP 
UNBIND 


+RSP 
NOTIFY 


$0590083-0 
Figure A-5 (Part 5 of 7). SNUF Session Protocols 
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Abnormal End to a Session (via End-of-Session 
Operation) 


System/36 


Term-Self 


+RSP 
UNBIND 

+RSP 

NOTIFY 


S0590084-1 
Figure A-5 (Part 6 of 7). SNUF Session Protocols 


Disable 


System/36 


REQDISCON 
+RSP 
DACTLU 


DACTLU 


DACTPU 


DISCONNECT 


S0590085-0 
Figure A-5 (Part 7 of 7). SNUF Session Protocols 
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SNA 3270 


Figure A-6 shows flow sequences for line activity 
between a System/36 using SNA 3270 device 
emulation and the host system. The sequences are 
shown in logical order and emphasize the main host 
system and System/36 commands that are issued. The 
following operations are shown: 

— Enable 

— Session Initialization via System/36 Work Station 
— Initialization by Host System 

— Inbound Data 

— Qutbound Data 

— Shut Down or Signal Command from Host System 
— End of Session 

— Disable Session 


Enable 


System/36 


ENABLE Command 


+RSP 


+RSP 


$05390071-0 


Figure A-6 (Part 1 of 8). SNA 3270 Session Protocols 
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Session Initialization via System/36 Work Station 


System/36 


ES3270 
(Sign on a work station) 


NOTIFY 
+RSP (NOTIFY) 
LOGON 
+RSP (LOGON) 
BIND 
+RSP (BIND) 


SDT 
+RSP (SDT) 


$0590072-0 


Figure A-6 (Part 2 of 8). SNA 3270 Session Protocols 


Initialization by Host System 


System/36 


ES3270 
(Sign on a work station) 


SIMLOGON 
NOTIFY 
+RSP (NOTIFY) 
BIND 
+RSP (BIND) 


+RSP (SDT) 


S0590073-0 
Figure A-6 (Part 3 of 8). SNA 3270 Session Protocols 
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Inbound Data—System/36 to Host System (LU-to-LU 
Normal) 


System/36 


PUT BC, BB, ER 
PUT MC, ER 


PUT EC, CD, DR 
+RSP (FMD) 


$0590075-0 


Figure A-6 (Part 4 of 8). SNA 3270 Session Protocols 


Outbound Data—Host System to System/36 (LU-to-LU 
Normal) 


System/36 


BC, BB, EB, ER, DATA 
MC, ER, DATA 


EC, DR, DATA 


+RSP (FMD) 


$0590074-0 


Figure A-6 (Part 5 of 8). SNA 3270 Session Protocols 
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Shut Down or Signal Command from Host System 
(Expedited Requests) 


System/36 


SHUTD 


+RSP (SHUTDOWN) 
PUT SHUTDOWN COMPLETE 


+RSP (SHUTDOWN COMPLETE) 
UNBIND 


SIGNAL 
+RSP (SIGNAL) 


$0590076-1 


Figure A-6 (Part 6 of 8). SNA 3270 Session Protocols 


End of Session (via Work Station Power Down) 


System/36 


LOGOFF 
TERM-SELF 


+RSP (TERM-SELF) 
UNBIND 

NOTIFY 

+RSP (UNBIND) 


+RSP (NOTIFY) 


$0590077-0 


Figure A-6 (Part 7 of 8). SNA 3270 Session Protocols 
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Disable Session 


System/36 


‘DISABLE’ Command 
REQDISCONT 


+RSP (REQDISCONT) 


DACTLU 
+RSP (DACTLU) 


DACTLU 
+RSP (DACTLU) 
DACTPU 


+RSP (DACTPU) 


DISCONNECT 


$0590078-0 


Figure A-6 (Part 8 of 8). SNA 3270 Session Protocols 
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SNA MSRJE 


Figure A-7 shows the sequences generated when a 
System/36 user starts an RJE session with the host 
system (the MSRJE procedure command is entered at a 
display station). The following operations are shown: 
— Initialization 

— System/36-lInitiated Bracket Reader 

— System/36-Initiated Bracket Console 

— Host System-Initiated Bracket 

— System/36 Request Direction Change 

— Host System Request Direction Change 

— Host-Detected Error 

— Host System Interrupts Outbound Data 

— System/36 Interrupts Inbound Data 

— System/36-Initiated Termination Sequence 

— Host System-Initiated Termination Sequence 


Initialization 


System/36 


ACTPU, RQD 


+RSP 


ACTLU, RQD 
+RSP 


LOGON, RQD 


LOGON eee 
Used BIND, RQD 
+RSP (BIND) 
SDT, RQD 
+RSP (SDT) 
ACTPU, ROD 
+RSP 
ACTLU, RQD 
+RSP 
LOGON 
Not Used pee 


+RSP (BIND) 


SDT, RQD 
+RSP (SDT) 


$0590062-0 


Figure A-7 (Part 1 of 13). SNA MSRJE Session Protocols 
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System/36-Initiated Bracket Reader 


System/36 


BB, OC, ROD, FMHDR 
(BDS, READER) 


BC, ROE, DATA 
MC, ROE, DATA 


EC, RQD, DATA 


EB, OC, RQD, FMHDR 
(EDS, READER) 


$0590100-0 


Figure A-7 (Part 2 of 13). SNA MSRJE Session Protocols 


System/36-Initiated Bracket Console (MSRJE Console 
Enter Key) 


System/36 


BB, EB, BC, EC, RQD, FMHDR 


(BEDS, CONSOLE), DATA 


$05390101-0 


Figure A-7 (Part 3 of 13). SNA MSRJE Session Protocols 
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Host System-Initiated Bracket (Host Sends Data to 
System/36) 


System/36 


BID, ROD 


BB, BC, ROE, FMAHDR 
(BDS, PRINT), DATA 


MC, ROE, DATA 


EC, RQD, DATA 


EB, OC, RQD, FMHDR 
(EDS, PRINT), DATA 


BB, OC, RQD, FMHDR 
(BDS, PRINT), DATA 


BC, ROE, DATA 
MC, ROE, DATA 


EC, RQD, DATA 


EB, OC, FMHDR 
(EDS, PRINT), DATA 


$0590102-0 


Figure A-7 (Part 4 of 13). SNA MSRJE Session Protocols 
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System/36 Requests Direction Change (System/36 
Interrupts Outbound Data Flow to Send Console Data) 


System/36 
See Sr a a a a a 


BID, ROD 
+RSP 


BB, OC, RQD, FMHDR 
(BDS, PRINT) 


+RSP 


BC, ROE, DATA 


Outbound SIGNAL, ROD 
Data Set (MSRJE has input) MC. ROE. DATA 


+RSP (SIGNAL) 
EC, RQD, DATA 


OC, ROD, CD, FMHDR 


+RSP (SDS, PRINT) 
Inbound 
Console BC, EC, CD, ROD, FMHDR 
(BEDS, CONSOLE), DATApata Set 
BC, ROD, FMHDR 
(RDS, PRINT) 
BC, ROE, DATA 
Outbound 
Data Set MC, RQE, DATA 
(continued) 


EC, RQD, DATA 


EB, OC, RQD, FMHDR 
(EDS, PRINT) 


$0590103-0 
Figure A-7 (Part 5 of 13). SNA MSRJE Session Protocols 
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System/36 Requests Direction Change (System/36 
Interrupts Outbound Data Flow to Send Reader Data) 


System/36 


BB, OC, ROD, FMHDR 
(BDS, PUNCH) 


BC, ROE, DATA 
MC, ROE, DATA 
SIGNAL, ROD 
Outbound (MSRJE has input) MC. ROE. DATA 


+RSP (SIGNAL) 
EC, ROD, DATA 


CD, OC, RQD, FMHDR 


(SDS, PUNCH) 

iis ‘ Oc, ROD, FMHDR 
nboun 

(BDS READER) 
Reader +RSP 
Data Set BC, ROE, DATA 

MC, ROE, DATA 
(continued) 
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Figure A-7 (Part 6 of 13). SNA MSRJE Session Protocols 
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System/36 Requests Direction Change (System/36 
Interrupts Reader Data to Send Console Data) 


System/36 [Host System 


(continued) (console has input) 
EC, RQD, DATA 


EC, RQD, DATA 


+RSP 
OC, RQD, FMHDR ieshesle 
(SDS, READER) asta ney 
+RSP > interrupt 
OC, ROD, FMHDR reader if 
Inbound (BEDS, CONSOLE), DATA +RSP necessary) 
Reader 
Data Set OC, RQD, FMHDR 
(RDS, READER) 
BC, RQE, DATA 
MC, RQE, DATA 
EC, RQD, DATA 
CD, OC, ROD, FMHDR 
(EDS, READER) 
OC, RQD, FMHDR 
(RDS, PUNCH) 
BC, ROE, DATA 
Outbound : MC, ROE, DATA 
Data Set 


EC, RQD, DATA 


EB, OC, RQD, FMHDR 
(EDS, PUNCH) 
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Host System Requests Direction Change (Host Interrupts 
Reader Data to Send Console Data) 


System/36 


BB, OC, RQD, FMHDR 
(BDS, READER) 


BC, RQE, DATA 
MC, RQE, DATA 


SIGNAL, ROD 
ee MC, ROE, DATA 
Data Set ‘ ’ 
+RSP, (SIGNAL) 
EC, RQD, DATA 
OC, RQD, CD 
BC, RQE, FMHDR 
(BEDS, CONSOLE), DATA 
puwmoune MC, ROE, DATA 
Data Set 
EC, RQD, CD, DATA 
BC, ROE, DATA 
MC, ROE, DATA 
Inbound 
Data Set 
(continued) 


EB, OC, RQD, FMHDR 
(EDS, READER) 
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Host-Detected Error (Host Terminates Inbound Reader 
Data) 


System/36 


BB, OC, RQD, FMHDR 
(BDS, READER) 


BC, RQE, DATA 
MC, RQE, DATA 
-RSP 


CANCEL or EC, RQD, DATA 


+RSP (CANCEL) 
EB, OC, ROD 


or 


EB, OC, FMHDR 
(ADS, READER) 
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Figure A-7 (Part 9 of 13). SNA MSRJE Session Protocols 


This document contains restricted materials of IBM. LY21-0590-4 
©Copyright IBM Corp. 1983, 1984, 1985, 1986 


Host System Interrupts Outbound Data to Send Console 
Output Data 


System/36 
S88 8 dw Meee ee 


BB, OC, RQD, FMHDR 
(BDS, PRINT), DATA 


BC, ROE, DATA 
MC, ROE, DATApata Set 1 


EC, RQD, DATA 


OC, RQD, FMDHR 


(SDS, PRINT) 
Data Set 2 BC, ROE, DATA 
Default — MC, ROE, DATA 
Destination 
Is Console 
OC, ROD, FMHDR 
(RDS, PRINT), DATA 
BC, ROE, DATA 
Data Set 1 MC, RQE, DATA 
(continued) 


EC, ROD, DATA 


EB, OC, FMHDR 
(EDS, PRINT), DATA 
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System/36 Interrupted Inbound Data (System/36 
Interrupts Reader Data to Send Console Data) 


System/36 


BB, OC, RQD, FMHDR 
(BDS, READER), DATA 


BC, ROE, DATA 
Data Set 1 MC, ROD, DATA 


EC, ROD, DATA 


OC, ROD, FMHDR 


(SDS, READER) 
Console OC, ROE, FMHDR 
Data Set (BEDS, CONSOLE), DATA 


OC, ROE, FAHDR 
(RDS, READER) 


BC, ROE, DATA 
MC, RQE, DATA 


Data Set 1 EC, RQD, DATA 
(continued) 


EB, OC, RQD, FMHDR 
(EDS, READER) 
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System/36 Initiated Termination Sequence (Generated 
When System/36 Ends a Session with the Host 
System—an END Statement Was Entered or a Configured 
Delay Timer Elapsed) 


System/36 


RSHUTD, RQD 


+RSP 
DATA (OPTIONAL) 


RSP (IF REQUIRED) 
DATA (IF OPTIONAL) 


RSP (IF REQUIRED) 
CLEAR, ROD (OPTIONAL) 
+RSP (IF REQUIRED) 


UNBIND, ROD 
+RSP 


$05901 10-0 
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Host System Initiated Termination Sequence (Generated 
When Host System Ends an RJE Session with 
System/36) 


System/36 


SHUTD, ROD 
+RSP 
DATA (OPTIONAL) 
RSP (IF REQUIRED) 
DATA (OPTIONAL) 
RSP (IF REQUIRED) 
SHUTC, ROD 
+RSP 


DATA (OPTIONAL) 
RSP (IF REQUIRED) 


CLEAR, ROD (OPTIONAL) 


+RSP (IF REQUIRED) 


UNBIND, ROD 
+RSP 
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Remote Work Station 


Figure A-8 shows the protocols for the following remote 
work station operations: 

— Initialization 

Termination 

— Put Data 

— Get Data 


Initialization Sequence (Initiated When Operator Enters 
Vary-On Command at System Console) 


System/36 Remote Work Station Controller (5251-12) 
a SE i 


XID 
+RSP (XID) 


SNRM Unnumbered 
Acknowledgement (UA) 


ACTLU,RQD 

+RSP (ACTLU) 
(Vary On Successful message) 
BIND,RQD 

+RSP (BIND) 
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Termination Sequence (Initiated When Operator Enters 
Vary-Off Command at System Console) 


System/36 Remote Work Station Controller (5251-12) 


UNBIND,ROQD 


+RSP (UNBIND) 
DACTLU,ROQD 


(Vary Off Successful message) 


+RSP (DACTLU) 
REQMS,RQD 


+RSP (REQMS) 


RECFMS,RQD 
+RSP (RECFMS) 


DISCONNECT Unnumbered 


Acknowledgement (UA) 


$0590068-0 
Figure A-8 (Part 2 of 4). Remote Work Station Data Communications Line Protocols 


Put Data Sequence (Data Is Sent to Remote Work Station; 
Put Is Initiated When the TUB or PUB, Set Up for the 
Put, Is Posted to the Remote Work Station Task) 


System/36 Remote Work Station Controller (5251-12) 


(One Chain): 
PUT,OIC,RQD 
+RSP (PUT) 


(Multiple Chains): 


PUT,FOC,RQE 
PUT,MOC,RQE 


PUT,MOC,RQE 
PUT,LOC,ROD 


+RSP (PUT) 


$0590069-0 
Figure A-8 (Part 3 of 4). Remote Work Station Data Communications Line Protocols 
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Get Data Sequence (an Explicit READ Command Must 
First be Sent; Get Is Initiated When TUB, Set Up for the 
Get, Is Posted to the Remote Work Station Task) 


System/36 Remote Work Station Controller (5251-12) 


(One Chain): 


READ COMMAND 


(OIC, RQE,CD) DATA (OIC,RQE,CD) 


(Multiple Chains): 


READ COMMAND 


(OIC, RQE,CD) DATA (FOC,RQE) 


DATA (MOC, RQE) 


DATA. (MOC,RQE) 
DATA (LOC,RQE,CD) 


$0590070-0 
Figure A-8 (Part 4 of 4). Remote Work Station Data Communications Line Protocols 
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Finance 


Figure A-9 shows the flow sequences generated when a 
location is enabled to a 3601/4701 communications 
controller to communicate with an operational diskette. 
The controller has N logical work stations configured. 
For this example, logical work stations 2 and 5 are 
configured for auto-sign-on in the controller; the 
remainder are not. The following operations are shown: 
— Enable: Operational Diskette 

— Enable: To 3601/4701 Communications Controller 
— Disable: To 3601/4701 Communications Controller 
— Sign-On 

— Sign-On Response 

— Enable: To 3694 Document Processor 

— Disable: To 3694 Document Processor 
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Enable: Operational Diskette 


System/36 3601/4701 


ACTPU, ROD 


+RSP (ACTPU) 
ACTLU, ROD, DAF=X’02’ 


ACTLU, RQD, DAF=X’03’ 


ACTLU, ROD, DAF=X’N+1’ 
Where N = number of logical 
work stations configured for 
this location 


+RSP, DAF=X'02’ (ACTLU) 
+RSP, DAF=X’03' (ACTLU) 


+RSP, DAF=X’N+1° (ACTLU) 
INIT-SELF, ROD, OAF=X’02' 


+RSP, DAF=X’02’ (INIT-SELF) 
BIND, RQD, DAF=X’02’ 

+RSP, DAF=X'02’ (BIND) 
SDT, RQD, DAF=X‘02’ 


+RSP, DAF=X’02’ (SDT) 
INIT-SELF, RQD, OAF=X’05' 
+RSP, DAF=X’05’ (INIT-SELF) 
BIND, ROD, DAF=X’05’ 
+RSP, DAF=X’05’ (BIND) 
SDT, RQD, DAF=X’05' 


+RSP, DAF=X’05’ (SDT) 


$0590112-0 
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Enable: To 3601/4701 Communications Controller with 
System Monitor Specified 


System/36 3601/4701 


ACTPU, RQD 


+RSP (ACTPU) 


ACTLU, RQD, DAF=X’01' 


+RSP, DAF=X’01' (ACTLU) 
BIND, RQD, DAF=X’01' 


+RSP, OAF=X’'01’ (BIND) 
SDT, RQD, DAF=X’01° 


+RSP, OAF=X’'01' (SDT) 


$0590114-0 
Figure A-9 (Part 2 of 8). Finance Data Communications Line Protocols 


Disable: To 3601/4701 Communications Controller 
Communicating with System Monitor Session 


System/36 3601/4701 


SHUTD, ROD, DAF=X’01' 

+RSP, DAF=X’01' (SHUTD) 

SHUTC, RQD, DAF=X’'01' 
+RSP, DAF=X'01' (SHUTC) 
UNBIND, RQD, DAF=X’01' 

+RSP, DAF=X’01’° (UNBIND) 
DACTLU, RQD, DAF=X’01' 

+RSP, DAF=X’01' (DACTLU) 
DACTPU, RQD 


+RSP, (DACTPU) 


$0590115-0 
Figure A-9 (Part 3 of 8). Finance Data Communications Line Protocols 


Appendix A: Data Communications Line Protocols A-49 
This document contains restricted materials of IBM. LY21-0590-4 
©Copyright IBM Corp. 1983, 1984, 1985, 1986 


Disable: To 3601/4701 Communications Controller 
Controlling Teller Work Stations (in This Example, Two 
Work Stations Are Configured and Operational) 


System/36 3601/4701 


SHUTD, ROD, DAF=X'02' 
SHUTD, ROD, DAF=X’'03’ 


+RSP, DAF=X’02’ (SHUTD) 
SHUTC, RQD, DAF=X’02’ 
+RSP, DAF=X'‘03’ (SHUTD) 
SHUTC, RQD, DAF=X'03' 
+RSP, DAF=X'02’ (SHUTC) 
UNBIND, ROD, DAF=X'02’ 
+RSP, DAF=X’03’ (SHUTC) 
UNBIND, ROD, DAF=X’'03’ 
+RSP, DAF=X’02’ (UNBIND) 
+RSP, DAF=X’03’ (UNBIND) 
DACTLU, ROD, DAF=X’'02’ 
DACTLU, RQD, DAF=X’03’ 
+RSP, DAF=X’02’ (DACTLU) 
+RSP, DAF=X’03’ (DACTLU) 
DACTPU, ROD 


+RSP (DACTPU) 
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Sign-On: A 3601/4701 Operator Signs On a Teller Work 
Station (in This Example, the Teller Is at Logical Work 
Station 3) 


System/36 3601/4701 


INIT-SELF, RQD, OAF=X’03' 
+RSP, DAF=X’03’ (INIT-SELF) 
BIND, RQD, DAF=X’03' 

+RSP, DAF=X'03’ (BIND) 
SDT, ROD, DAF=X'03’ 


+RSP, DAF=X’'03’ (SDT) 


$0590117-0 
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Sign-On Response (in This Example, an Operator at 
Logical Work Station 3 Does a Transaction) 


System/36 3601/4701 


DATA (Procedure start request 
of the form - *EXEC Progname 
Data...) 


DAF=X’03', BC, EC 
DATA, DAF=X’03', BC, EC 
DATA, BC, ECDAF=X’03' 


$0590118-0 
Figure A-9 (Part 6 of 8). Finance Data Communications Line Protocols 


Enable to 3694 Document Processor 


System/36 


ACTPU, RQD 
+RSP (ACTPU) 

ACTLU, RQD, DAF=X’02' 
+RSP DAF=X'02’ (ACTLU) 
INITSELF, RQD, DAF=X'02’ 


+RSP, DAF=X’02’ (INITSELF) 
BIND, RQD, DAF=X’02' 


+RSP, DAF=X’02’ (BIND) 
SDT, RQD, DAF=X’02' 


+RSP, DAF=X’02’ (SDT) 


$0590119-0 
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Disable to 3694 Document Processor 


System/36 


SHUTD, ROD, DAF=X’02’ 
+RSP, DAF=X'02’ (SHUTD) 
SHUTC, RQD, DAF=X'02’ 
+RSP, DAF=X'02’ (SHUTC) 
UNBIND, RQD, DAF=X’02' 


+RSP, DAF=X’'02’ (UNBIND) 


DACTLU, ROD, DAF=X’02’ 

+RSP, DAF=X’02’ (DACTLU) 
DACTPU, ROD 

+RSP, (DACTPU) 


$0590120-0 
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SNA Peer Subsystem 


Figure A-10 shows the protocol flow generated when 
line and session activation/deactivation takes place 
between the System/36 Peer subsystem support and 
the remote system. The line activation / deactivation 
portions show two types of flow: protocol flow between 
the two SDLCs and flow between the two Peer 
subsystems. 


The following Peer operations are shown: 

— Enable Primary: Line Activation 

— Enable Primary with Remote Rejection of RLOCID 

— Enable Secondary: Line Activation 

— Enable Secondary with Remote Rejection of RLOCID 

— Disable Primary: Line Deactivation 

— Disable Secondary: Line Deactivation 

— Disable Remote Secondary: Line Deactivation 

— Disable Remote Primary: Line Deactivation 

— Establish Peer Configuration Session: Session 
Activation 

— Establish Remote System Session: Session Activation 

— Peer Terminates a Session It Created 

— Peer Terminates a Remotely-Created Session 

— Remote System Terminates a Session It Created 

— Remote System Terminates a Peer-Created Session 

— Acquire 

~ Evoke 

— Evoke End of Transaction 

— Evoke Then-Get/Invite 

— Put 

— Put Then-Get/Invite 

— Put End of Group 

— Put End of Transaction 

— Put Fail 

— Get/Invite/Accept-Input 

— Local Half-Session in Transmit Mode Must Switch to 
Receive 

— Request Change Direction 

— Release 

— End of Session 
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Enable Primary: Line Activation 


System/36 Peer Primary SDLC Secondary SDLC 
eee eS SS Se ea ae ee eS ee | 


RLOCID 


RLOCID 
+RSP RLOCID 


+RSP RLOCID 
The SPS configuration is 


now ready to establish 
sessions. 


Note: X/D and XID response flow are only on System/36 Peer leased line configurations. 
$0590181-1 
Figure A-10 (Part 1 of 31). Peer Subsystem Activation/Deactivation 


Enable Primary with Remote Rejection of RLOCID: Line 
Activation 


System/36 Peer Primary SDLC Secondary SDLC 


XID 
XID 
SNRM 
UA 
RLOCID 
pt _ 


epeseteeiD De 


DISC 
UA 


Note: X/ID and XID response flow are only on System/36 Peer leased line configurations. 


RLOCID 


-RSP RLOCID 


$0590182-1 
Figure A-10 (Part 2 of 31). Peer Subsystem Activation/Deactivation 


Enable Secondary: Line Activation 


System/36 Peer Primary SDLC Secondary SDLC 
Pe ete ES ae eee TEE ee 


RLOCID 


RLOCID 
+RSP RLOCID 


+RSP RLOCID 


The SPS configuration is 
now ready to establish 
sessions. 


Note: X/D and XID response flow are only on System/36 Peer leased line configurations. ere 


Figure A-10 (Part 3 of 31). Peer Subsystem Activation/Deactivation 


Enable Secondary with Remote Rejection of RLOCID: Line 
Activation 


System/36 Peer Primary SDLC Secondary SDLC 


RLOCID 
RLOCID 


+RSP RLOCID 


-RSP RLOCID 


Note: X/D and XID response flow are only on System/36 Peer leased line configurations. spetnitus 


Figure A-10 (Part 4 of 31). Peer Subsystem Activation/Deactivation 
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Disable Primary System: Line Deactivation 


System/36 Peer Primary SDLC poysten/ sarees ___:pumary SBEC_ — — 4). Secondary SULC_._ | emotemystem: ____._| SDLC 


+RSP QSESS 
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Figure A-10 (Part 5 of 31). Peer Subsystem Activation/Deactivation 


Disable Secondary Configuration: Line Deactivation 


System/36 Peer Primary SDLC Secondary SDLC 
as: ns Ges (ns 


Cf +RSP RLOCID 


UA 
DISC 
UA 


Figure A-10 (Part 6 of 31). Peer Subsystem Activation/Deactivation 
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Disable Remote Secondary Location: Line Deactivation 


System/36 Peer vere eee ema SekeS  eecondaty oer eee SDLC Secondary SDLC 


+RSP QSESS 
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Figure A-10 (Part 7 of 31). Peer Subsystem Activation/Deactivation 


Disable Remote Primary Location: Line Deactivation 


System/36 Peer Primary SDLC Secondary SDLC 


DISC 
UA 


$0590188-0 


Figure A-10 (Part 8 of 31). Peer Subsystem Activation/Deactivation 
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Establish Peer Configuration Session: Session Activation 


System/36 Peer 


BIND FSP, PACING 
+RSP BIND, PACING 


S0590189-0 
Figure A-10 (Part 9 of 31). Peer Subsystem Activation/Deactivation 


Establish Remote System Session: Session Activation 


System/36 Poor 


BIND FSP, PACING 
+RSP BIND, PACING 


S05390190-0 
Figure A-10 (Part 10 of 31). Peer Subsystem Activation/Deactivation 


Peer Session Deactivation 


Peer Subsystem Terminates Session It Created 


System/36 Peer 


UNBIND 
RSP UNBIND 


$0590191-0 


Figure A-10 (Part 11 of 31). Peer Subsystem Activation/Deactivation 


This document contains restricted materials of IBM. LY21-0590-4 
©Copyright IBM Corp. 1983, 1984, 1985, 1986 


Peer Subsystem Terminates Remotely-Created Session 


aaa ae 


RSHUTD 


RSP RSHUTD 
UNBIND 
+RSP UNBIND 


$0590192-0 
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Remote System Terminates a Session It Created 


System/36 Peer Remote System 


UNBIND 
+RSP UNBIND 
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Remote System Terminates a Peer-Created Session 


System/36 Peer Remote System 


RSHUTD 


RSP RSHUTD 
UNBIND 


+RSP UNBIND 


$0590194-0 
Figure A-10 (Part 14 of 31). Peer Subsystem Activation/Deactivation 
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SSP-ICF Peer Operations 
Acquire (ACQ) 
If preestablished sessions are available, no line flow 


occurs. If preestablished sessions are not available, the 
following line flow takes place: 


System/36 Peer 


+RSP BIND 


$0590195-0 
Figure A-10 (Part 15 of 31). Peer Subsystem Activation/Deactivation 


Evoke (EVK) 


ATTACH FMHS5, [Init Data] 
FI,BC,EC,DR [BB] 


$0590196-0 
Figure A-10 (Part 16 of 31). Peer Subsystem Activation/Deactivation 


Evoke End of Transaction (EVE) 


ATTACH FMH5, [Init Data] 
FI,BC,EC,DR [BB] EB 


$0590197-0 
Figure A-10 (Part 17 of 31). Peer Subsystem Activation/Deactivation 
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Evoke Then-Get/Invite (EVG/EVI) 


SSS eS SSS SSS SSS S55 sss I 5 9 5S 90 aa = SSS SD 


ATTACH FMHBS5, [ Init Data ] 


FI,BC,EC,ER [BB] CD Logical Record 


$0590198-0 
Figure A-10 (Part 18 of 31). Peer Subsystem Activation/Deactivation 


Put 


Note: For all put operations, BC is sent only if the put 
operation is issued while the half-session is between 
chains. 


[ User Data ] 
[BC] ER 


$0590199-0 
Figure A-10 (Part 19 of 31). Peer Subsystem Activation/Deactivation 


Put Then-Get/Invite (PTG/PT1) 


System/36 Peer Remote System 


GRTPUT, [ User Data ] 
[BC] EC ERCD 


Logical Record 


$0590200-0 
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Put End of Group 


End-Group, [ User Data ] 
[BC] EC DR 


$0590201-0 
Figure A-10 (Part 21 of 31). Peer Subsystem Activation/Deactivation 


Put End of Transaction (PEX) 


[ User Data ] 
[BC] EC, DR 


Program Stop 
BC, EC, DR, EB 


$0590202-0 
Figure A-10 (Part 22 of 31). Peer Subsystem Activation/Deactivation 


Put Fail (Local Half-Session in Transmit Mode) 


System/36 Peer 


Fail 
[BC] EC, DR 


$0590203-0 
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Put Fail (Local Half-Session in Receive Mode) 


System/36 Peer 


Hard Break Signal 
(to force a turnaround) 


+RSP SIGNAL 


Fail 
[BC] EC, DR 


$0590204-0 
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Get /Invite /Accept-Input (GET) 


If the local half-session is in receive mode: 


Logical Record 


$0§90205-0 
Figure A-10 (Part 25 of 31). Peer Subsystem Activation/Deactivation 


If the local half-session is in transmit mode and wants 
to receive: 


System/36 Peer Remote System 


GRTPUT [BC] EC, ER, CD 


(grant put) 


Logical Record 


$0590206-0 
Figure A-10 (Part 26 of 31). Peer Subsystem Activation/Deactivation 
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Request Change Direction—Get/Invite (RCDG/RCDI) 


Soft Break Signal 
(to request turnaround) 


+RSP SIGNAL 


Logical Record 


$0590207-0 
Figure A-10 (Part 27 of 31). Peer Subsystem Activation/Deactivation 


Release (REL) 


If the session had been preestablished, no line flow 
occurs. If the session had not been preestablished, the 
following flow occurs: 


System/36 Peer 


UNBIND 


+RSP UNBIND 


$0590208-0 
Figure A-10 (Part 28 of 31). Peer Subsystem Activation/Deactivation 
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End of Session (EOS) 


lf the local half-session is in transmit mode: 


Program Term 
EC DR 


$0590209-0 
Figure A-10 (Part 29 of 31). Peer Subsystem Activation/Deactivation 


If the local half-session is in receive mode: 


System/36 Peer Remote System 


Hard Break Signal 
(to force a turnaround) 


+RSP SIGNAL 


Program Term 
BC, EC, DR 


$0590210-0 
Figure A-10 (Part 30 of 31). Peer Subsystem Activation/Deactivation 


If the session had been preestablished, no control flow 
occurs. If the session had not been preestablished, the 
following occurs: 


UNBIND 


+RSP UNBIND 


$0590211-0 
Figure A-10 (Part 31 of 31). Peer Subsystem Activation/Deactivation 
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APPC Subsystem 


Figure A-11 shows the protocol flow generated when 
line and session activation/deactivation and data 
transmission take place between the System/36 APPC 
subsystem and the remote system. 


The following APPC operations are shown: 


Enable: Peer Network with Remote Configured as 
Primary 

Enable: Host-Type Network 

STARTGRP Command 

Session Initiation /Allocation 

Transaction Initiation 

Input/Output 

Session Deallocation/Termination 

STOPGRP Command 

Disable 
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Enable: Peer Network with Remote Configured as 
Primary 


System/36 APPC Secondary SDLC Primary SDLC 


$0590394-0 
Figure A-11 (Part 1 of 10). APPC Subsystem Enable 


Enable: Host-T ype Network 


System/36 APPC Secondary SDLC Primary SDLC 
a EEE 


+RSP 


+RSP 
NOTIFY 


$0590395-0 
Figure A-11 (Part 2 of 10). APPC Subsystem Enable 
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STARTGRP Command 


LU Services Model APPC Subsystem Operation C/SNA Line Sequence 


SPECIAL ACQUIRE INITIATE SESSION 
(see Note 1) 


SEND DATA FMH5, TPN=X’O6F 1’ 
[ BB ],BC,DR1,ERI,Fl 


PUT-INVITE SEND DATA CNOS (request) 
Prepared to Receive EC,CD,DR1,ERI 
(see Note 2) 


RECEIVE DATA CNOS (reply) 
OIC,CEB,DR1,ERI 
ACCEPT 


END OF SESSION TERMINATE 
SESSION 
(see Note 3) 


Notes: 


1. See Session Initiation/ Allocation for detail line flows concerning the acquire operations. 


2. Parallel session connections only. For single-session connections the CNOS exchange is not 
performed; only the post to the subsystem is performed. 


3. See Session Deallocation/ Termination detail line flows concerning the end-of-session operations. 


$0590396-2 
Figure A-11 (Part 3 of 10). APPC Subsystem STARTGRP Command 
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Session Initiation/Allocation 


If preestablished sessions are available, no line flow 
occurs. If preestablished sessions are not available, the 
following line flow takes place. 


Application Program Subsystem C/SNA Line Remote 
Operation Operation Sequence System 
SS am aaa eee SS 


HOST-type network using migration mode: 


INITIATE INITSELF 
SESSION 
SPECIAL 
ACQUIRE 
or +RSP 
ACQUIRE 


Peer-type network: 


INITIATE 
SESSION 


$0590397-0 


Figure A-11 (Part 4 of 10). APPC Subsystem Session Initiation/Allocation 
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Transaction Initiation 


Application Program Subsystem C/SNA Line Remote 
Operation Operation Sequence System 
FT a a ee ee SSS 


EVOKE, Send Data 

EVOKE-GET, 

EVOKE-INVITE, or 

EVOKE-EOX +or- RSP 


(All of the above (if CONFIRM) 
can include the 
CONFIRM modifier) 


Receive Data Data or Control 
(if EVOKE-GET or Information 
EVOKE-INVITE) 


Note: The +RSP to confirm is not required if GET was specified. Instead, the data or control information 
is treated as a+RSP acknowledgment. 


$0590413-2 
Figure A-11 (Part 5 of 10). APPC Subsystem Transaction Initiation 
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Input /Output 


Application Program Subsystem C/SNA Line Remote 
Operation Operation Sequence System 


SEND Data Data or 
LUSTAT 
RECEIVE Data 


(if PUT-GET 
or PUT-INVITE) 


PUT, 

PUT-GET, 
PUT-INVITE, 

or PUT-END-OF 
-TRANSACTION 
(All of the above 
can include the 
CONFIRM modifier) 


+ or - RSP 
(if CONFIRM) 


Data or Control 
Information 


GET (send state) 
RECEIVE Data 


RECEIVE Data 


Request to Signal 
SEND 


RECEIVE Data 


GET (receive state) 


Data or Control 
Information 


Request Change 
Direction with 


GET or INVITE +RSP 


Data or Control 
Information 


FAIL 
(send state) 
or 
FAIL 

(receive state) 


SEND Data FMH7 


or 


SEND Error -RSP 


Note: The+RSP is not required if GET was specified. Instead, the data or control information 
is treated as a+RSP acknowledgment. 


$0590414-2 


Figure A-11 (Part 6 of 10). APPC Subsystem Input/Output 
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Session Deallocation/Termination 


Application Program Subsystem C/SNA Line Remote 
Operation Operation Sequence System 


Normal Termination 


Release BIS BIS 

or REQUEST DR1,ERI 

End of Session 
BIS 
DR1,DR2,ERI 


Terminate UNBIND 
Session 


+ or - RSP 


Forced Termination 


Terminate UNBIND 


Session 


Note: If the session had been preestablished, the session remains bound. 


+ or - RSP 


$0590415-1 
Figure A-11 (Part 7 of 10). APPC Subsystem Session Deallocation/Termination 
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STOPGRP Command 


LU Services Model APPC Subsystem Operation C/SNA Line Sequence 
DT eee ggggg8ESE|EF FEE — esas Sass! 


SPECIAL ACQUIRE INITIATE SESSION 
(see Note 1) 


EVOKE SEND DATA FMH5, TPN=X’O6F 1’ 
[BB ],BC,DR1,ERI,Fl 


PUT-INVITE SEND DATA CNOS (request) 
(CLOSE) Prepared to Receive EC,CD,DR1,ERI 
(see Note 2) 


RECEIVE DATA CNOS (reply) 
OIC,CEB,DR1,ERI 


ACCEPT 


END OF SESSION TERMINATE 
SESSION 
(see Note 3) 


Notes: 


1. See Session Initiation/ Allocation for detail line flows concerning the acquire operations. 


2. Parallel session connections only. For single-session connections the CNOS exchange is not 
performed; only the post to the subsystem is performed. 


3. See Session Deallocation/ Termination detail line flows concerning the end-of-session operations. 


$0590029-2 
Figure A-11 (Part 8 of 10). APPC Subsystem STOPGRP Command 
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Disable: Peer Network with Remote Configured as 
Primary 


System/36 APPC Secondary SDLC Primary SDLC 


1 eee Ee 
CLOSE LOC RD 
UA 
m= DISC 
UA 


$0590411-0 


Figure A-11 (Part 9 of 10). APPC Subsystem Disable 


Disable: Host-Type Network 


System/36 APPC Secondary SDLC Primary SDLC 
fo a a ee 


REQDIS- 
CLOSE LOC CONT 


DACTLU 
+RSP 
DACTLU 


+RSP 


$0590412-0 


Figure A-11 (Part 10 of 10). APPC Subsystem Disable 
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APPN Subsystem 


Figure A-12 shows the protocol flow between the 
control point modules within the APPN subsystem. 
Since these control point modules communicate using a 
modified APPC subsystem, the lower level protocol 
flows are the same as those for APPC. 


The following APPN operations are shown: 

— Fable: Between Two APPN Nodes with Both 
Enabled as Networking Nodes 

— Topology Update: Between Two APPN Nodes 

— Session Request: If Directory Services and Network 
Search Are Required 
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Enable: Between Two APPN Nodes with Both Enabled 
as Networking Nodes 


Control Point Remote Control Point 
a a 


> Send iocal capabilities and request rem0t€ > 
<‘(eeees Send local capabilities and request remote <jqmmees 


<ooees Reply to request and return local capablittles EEE EEE: 
WT Reniytorequest andreturn local capabiliteC  ____ E> 


JIU G@@@ > Exchange topology data base 
<o Exchange topology data base I a a 


a> Propagate topology data base updates _ i 
‘oes Propagate topology data base updates <u 


Note: This sequence will occur whenever a line is enabled on the CPSVCMG session between 
two networking nodes on the line and/or whenever the CPSVCMG session fails and is 
brought back up. 


$05904390-0 
Figure A-12 (Part 1 of 3). APPN Subsystem Enable 
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Topology Update: Between Two APPN Nodes 


Control Point Remote Control Point 


External event 


TTT LOOoiOgy database update se 


<ees Propagate topology data base update <= 


Note: External event is any action that affects the networks topology such as a node or link changing 
status, nodes becoming congested for routing, and disable pending. These will cause updates to 
flow throughout all the attached and communicating network nodes. 

$0590491-0 


Figure A-12 (Part 2 of 3). APPN Subsystem Topology Update 
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Session Request: If Directory Services and Network 
Search Are Required 


Control Point | Remote Control Point 


a 
eT A a RTE ees p> (~~) | (\| |] Maaco EE 
Sa ee ee Fic Ra Rae 


SEE a IIIS | CCC) {Spey 
rs CDN 
EE ET a REASONED, = 11) CO) RE ners 


Note: /f directory services has previous knowledge of the requested location, a directed search will be 
sent. This is similar to a BIND flowing where the route is specified. If directory services has 
no knowledge of the requested location, the originating nodes and all nodes that receive the search 
request will send a search request to all of their neighbors (unless they are the requested location). 
$0590492-0 
Figure A-12 (Part 3 of 3). APPN Subsystem Session Request 
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X.25 Line Protocols 


Figure A-13 shows the protocol flow within the X.25 
link. 


The following X.25 operations are shown: 
— Establishing the X.25 Link 

— Terminating the X.25 Link 

— Opening an X.25 Virtual Circuit 

— Closing an X.25 Virtual Circuit 

— Transferring Data in an X.25 Network 


Establishing an X.25 Link 


SNA/RWS X.25 Tasks Control Storage X.25 Network 
X.25 Microcode 
a a ee 


First Line 


Open Line Open 


Complete 


ENABLE 
lOB 


ENABLE-WITH 


LOAD IOB ENABLE-WITH- 
LOAD Complete 


Open Link 
1IOB 


RESTART 


Request RESTART 
Confirmation 


Open Link 


Complete 
ENABLE 


Complete 


Link to Network is now active 


$0590386-1 
Figure A-13 (Part 1 of 7). X.25 Link Initialization 
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Terminating an X.25 Link 


SNA/RWS X.25 Tasks Control Storage X.25 Network 
X.25 Microcode 
ea aaa aaa aa aaa a SSS aa a ee aaa 


Other SNA/RWS still using the X.25 link 


Terminate / 

Detach Request 
Ignored for 
Outstanding 
write lIOBs 


IOBs 


Termination / 
Detach 
Complete 


Figure A-13 (Part 2 of 7). X.25 Link Termination 
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Establishing an X.25 Virtual Circuit in Response to an 
Incoming Call 


SNA/RWS X.25 Tasks Control Storage 
X.25 Microcode 
| me a a ee 


Virtual circuit not established 


Open Station 
lOB 


| Request placed 
on CWOQ | 


Open Staton 
Complete 


Incoming Call 
Packet 


In Call Packet 
Received 


Open SVC 
In |OB 


Call Accepted 


Open SVC 
in Complete 


$0590388- | 


Figure A-13 (Part 3 of 7). Opening an X.25 Virtual Circuit 
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Establishing an X.25 Virtual Circuit for an Outgoing Call 


SNA/RWS X.25 Tasks Control Storage X.25 Network 
X.25 Microcode 
Ng i rng rag eR IN ig a et 


Virtual circuit not established 


Open Station 

lIOB 
Open Station 
Complete 


Open SVC 
Out IOB 


Call Request 


Call Connected 


Open SVC 
in Complete 


$0590389-1 
Figure A-13 (Part 4 of 7). Opening an X.25 Virtual Circuit 
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Closing an X.25 Virtual Circuit 


SNA/RWS X.25 Tasks Control Storage 
X.25 Microcode 
a a a ee ee ee 


Virtual circuit in data transfer state 


DISC IOB 


| Transmit Only 


(PSDISC, QDISC, PSDISC, ODISC, 
LDISC) |IOB LDISC 


Transmit Only 
Complete 


PSDISC, QUA 
LUA 


Receive Only 
Complete 


Close SVC 
1OB 


Clear 
Request 


Clear 
Confirmation 


Close 
Complete 


DISC 
Complete 


$0590390-1 


Figure A-13 (Part 5 of 7). Closing an X.25 Virtual Circuit 
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Transmitting Data in an X.25 Link 


SNA/RWS X.25 Tasks Control Storage X.25 Network 
X.25 Microcode 


Write l|OB 


Transmit Only 
1OB 


Data 
Packet(s) 


Acknowledgment 
in RR Packet 


Transmit Only 
Complete 


Write l|OB 
Complete 


$0590331-0 


Figure A-13 (Part 6 of 7). X.25 Virtual Circuit Data Transfer 


Receiving Data in an X.25 Link 


SNA/RWS X.25 Tasks Control Storage X.25 Network 
X.25 Microcode 


Data Packet(s) 
Received 


Receive Only 
Complete 


Read Complete 


Return 
Read Only 


Return Receive 
Only IOB 


$0590392-0 


Figure A-13 (Part 7 of 7). X.25 Virtual Circuit Data Transfer 
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Appendix B: Programming Language Directory 


This appendix provides brief descriptions of compiler 
modules and routines, and execution-time subroutines 
of the following programming languages: 


e« Assembler 
¢« BASIC 

« COBOL 

e FORTRAN 
¢« RPG Il 


Use this directory when diagnosing problems relating to 
IBM language compilers and object code generated by 
them. The compiler information is provided for use in 
analyzing compile-time diagnostics and program dumps. 


The execution-time information consists of descriptions 
of subroutines built into user object programs. The 
subroutines provide specialized functions such as data 
conversion. For example, RPG Il uses a multiply 
subroutine to execute the MULT calculation 
specification. The subroutines are selected by the 
preassemble and assemble phases of the compiler and 
are included in the object program overlay segments by 
the overlay phases. 


This directory is organized by language. Each language, 
with the exception of BASIC, contains a directory for 
compiler modules and subroutines and a directory for 
execution time subroutines. (Because the BASIC 
language is interactive, the module descriptions are not 
organized by compile-time /execution-time types.) Each 
directory entry contains the module/routine name and a 
brief description of the module/routine’s function. 
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Assembler Language Directory 


ASSEMBLER LANGUAGE COMPILER MODULES 


Module Descriptive 

Name Name Function 

H#ASSEM Assembler Phase 05: Perform assembler initializaticn. Process OPTIONS, HEADERS, and 

(ZASROT, initialization input format (ICTL) control. #ASROT remains in storage and contains the work file 

#ASINO) DTFs and the common area. 

#ASCMO Compression Phase 10: Process all the source statements for the control statements. Build the 
intermediate text file and decode and test the source statements. Convert source 
names to 6-byte text record names. 

#ASSBO Symbol table Phase 20: Assign the location counter values and build the symbol table. 

build 
#ASSFO Symbol table Phase 21: Test the intermediate text from the statement following the overflow to 
overflow the end of the text for symbols that have been previously defined. Resolve all 
references to symbols that are defined in the present symbol table. 
#ASSSO Symbol Phase 22: Assign the symbol value and attribute from the last (or only) symbol 
substitution table to that symbol in the intermediate text term records. Build an ESL table for 
module name and EXTRN and ENTRY statements. Convert 6-byte ESL text record 
names to original source names to be stored in the ESL table. 

#ASPEO ESL output Phase 29: Print the OPTIONS and HEADERS records and the prolog. Convert 

(HASPRC, 6-byte title text names to original source name. Sort and print the ESL listing if 

#ASPE1) LIST is specified. #ASPRC remains in storage and contains the CAM macro. 

#ASPSO Source/object Phase 30: Generate object code for machine instructions and DCs. Put out object 

output code. Build printer image. Print source statements and object code generated. 
Perform assembly-time operations requested by assembler statements. Process 
machine instructions and assembler instructions. 

#ASPDO Print Phase 35: Read the error records and print diagnostic messages. Print the error 

diagnostics summary statements. 

#ASBXO Build XREF file Phase 40: Read the work file and create the cross-reference sort file. Initialize 
working storage, print area, and listing header for Phase 41. 

#ASSXO Merge and list Phase 41: Merge the XREF sort file. Generate the XREF listing. Print the error 

XREF summary statements. Fetch overlay linkage editor if object output is required. 
Convert 6-byte text record names to original source names for XREF listing. 
#MPXD Macro Phase 00: Read source statements from $SOURCE. Write assembler statements to 
processor SASMINPT. 
driver 

H#MPX1 Overlay router Phase 01: Transfer control to the proper overlay. Check for headers, prototypes, 
global, local, table definitions and call required phase. 

#MPX2 Statement Phase 02: Process MACRO, GBLA, LCLA, GBLB, LCLB, GBLC, LCLC, Prototype 

processor and macroinstruction. 

#MPX3 Statement Phase 03: Process AIF, AGO, SETB, MNOTE, MEXIT, MEND. 

processor 

HMPX4 Statement Phase 04: Process SETA, SETC. 

processor 
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BASIC Directory 


Module 
Name 


Function 


Descriptive Name 


#BLCHR 
#BLCLR 
#BLCMR 
#BLCPE 
#BLCSE 
#BLDAR 
#BLDEE 
#BLDIR 
#BLDSE 


#BLEDE 
#BLEER 
#BLERE 
#BLEXE 


#BLFOE 
#BLFPR 
#BLFRE 
#BLFSR 
#BLGSR 


#BLGTE 
#BLHPE 
#BLICR 


#BLIFR 
#BLIMR 
#BLINC 


#BLIOR 


#BLIPR 
#BLLDE 


Chain processor 

Close 

Communications |/O 
Command parser 
COLSEQ processor 
Data statement handler 
DEPARSER 

Library member |/O 


Edit-time display station 
manager 


Editor 
Run-time error exit handler 
BASICP error handler 


Expression parser 


Form statement parser 
Form processor 

Free 

Full screen processor 


Unformatted READ/GET I/O 
handler 


Get token 
Help mode processor 


Interactive compiler 


Find intrinsic function 
Image statement handler 


Normal run-mode 
initialization and nucleus 
functions 


Run-time common |/O 
handler 


INPUT and LINPUT 


LOAD command processor 


Set up execution of a new program by processing chain statement. 
Process the close statement. 

Performs communications file input/output operations. 

Parse BASIC commands and invoke appropriate command processor. 
Process the COLSEQ command. 

Process the data statement. 

Deparse (convert) intermediate text back to source statements. 
Performs library member input/output operations. 


Interface with SSP WSDM during BASIC edit. 


Perform line change operations. 
Process run-time errors. 
Handles BASICP run-mode errors. 


Convert expressions (contained in BITBF) to IT for the statement 
parser (#BLPAE). 


Convert form statements to IT for the statement parser (#BLPAE). 
Process the run-time FORM statement. 

Process the FREE command. 

Process INPUT and PRINT FIELDS statements. 


Process unformatted READ or stream file GET requests. 


Get tokens for the statement and command parsers. 
Perform help functions. 


Convert intermediate text to BASIC instruction set code that can be 
executed by the control storage BASIC instruction set emulator. 


Locate and create a table entry for a new intrinsic function. 
Process print image statement. 


Initialize BASIC for normal run mode and provide common nucleus 
functions. 


Perform general |/O dispatching functions. 


Set up |/O for BASIC INPUT and LINPUT statements. 
Process the BASIC LOAD and CLEAR commands. 


a 


Appendix B: Programming Language Directory B-3 


This document contains restricted materials of IBM. LY21-0590-4 
©Copyright IBM Corp. 1983, 1984, 1985, 1986 


Module 


Name Descriptive Name Function 

#BLLIE LIST command processor Process the LIST command. 

#BLLPE LISTP command processor Process the LISTP command. 

#BLLSE Source loader Load lines of source into the parse buffer. 

#BLMAR Matrix assign Perform matrix assign operation. 

#BLMGE MERGE command processor Process the MERGE command. 

#BLMIC MRT run-mode initialization —_ Initialize BASIC for MRT run mode and provide common nucleus 
and nucleus functions functions. 

#BLOPR Open disk files Process the OPEN statement for disk files, library members, and the 


local data area. 


#BLPAE Statement parser Parse BASIC source statement, build the intermediate text, and 
invoke the editor. 


#BLPFR Print using form Process control specifications from the using statement. 

#BLPIC BASICP run-mode Initialize BASIC for PROC run mode and provide common nucleus 
intialization and nucleus functions. 
functions 

#BLPOR Open printer files Process the printer OPEN statement. 

#BLPSR Unformatted put |/O handler Process unformatted write and stream file PUT I/O operations. 

#BLRER Run-time error handler Handle run-time warning error or trace conditions. 

#BLRFR Read using form Process read using statement. 

#BLRNE Renumber Renumber source statements. 

#BLRUE BASIC run/go command Switch the BASIC program product from edit mode to run mode. 
processor 

#BLSCR Special run-mode chain Load and initialize the user library SUBR member, and interface with 
processor the compiler. 

#BLSEE BASICS error handler Handle BASICS edit-mode errors and save the subroutine. 

#BLSIC Special run-mode Initialize BASIC for special run mode and provide common nucleus 
initialization functions. 

#BLSLS Source load Loads source for BASICS. 

#BLSNC BASICS edit-mode Initialize BASIC for source edit mode and provide common nucleus 
initialization and nucleus functions. 
functions 

#BLSSE Save source Write source to a library member. 

#BLSTR ASCII collate table The index is the equivalent EBCDIC character. 

#BLSVE SAVE command processor Process SAVE and REPLACE commands. 

#BLSXR Special run-mode termination Interface with SSP SYSLOG for special run-mode termination. 

#BLUPR Unformatted print Process unformatted PRINT statement. 

#BLWAR WAITIO handler Handle the WAITIO statement for work stations and ICF. 
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Module 


Name 


#BLWOR 


#BLXRE 
#BLXTR 
#BLOO(L,S) 


#BLO1(L,S) 


#BLO2 


#BLO2A 


#BLO3 
#BLO4 
#BLO5 


#BLO6 
#BLO7 
#BLO8 


#BLO9 
#BLOA 
#BLOB 


#BLOC 


#BLOD 
#BLOE 
#BLOF 


Descriptive Name 


Open work station files 


XREF handler 


Normal run-mode termination 


LOG(X), EXP(X) 
Exponentiation function 


RND intrinsic function 
CHR$(X) intrinsic function 


CHR§(X) intrinsic function for 
a given collating sequence 


DATES intrinsic function 
FILE$(X) intrinsic function 


LPADS(A$,X) intrinsic 
function 


LTRMS$(A$) intrinsic function 
LWRCS$(A$) intrinsic function 


RPADS(A$, X) intrinsic 
function 


RPT$(A$,X) intrinsic function 
RTRMS($A) intrinsic function 


SREP$(A$, X,B$,C$) intrinsic 
function 


STOP$ intrinsic function 


STR&$(X) intrinsic function 
TIME$ intrinsic function 


UPRC$(A$) intrinsic function 


Function 


Process the OPEN statement for work station and communications 
sessions. 


Provide a cross reference of a BASIC program. 
Save symbol table on disk and terminate normal run mode. 


Return (LOG(X), EXP(X), or ***X. 


Generate a random number, using RANDOMIZE. 
Return the character equivalent of decimal number X. 


Return the character equivalent from the given collating sequence of 
decimal number X. 


Return the current date. 
Return the number of the file X. 


Left pad character string A$ with blanks to create a character string 
of length X. 


Remove the leading blanks from character string A$. 
Convert uppercase letters in string A$ to lowercase. 


Right pad character string A$ with blanks to create a character string 
of length X. 


Repeat character string A$, X times. 
Remove the trailing blanks from character string A$. 


Return character string A$ with all occurrences of B$ replaced by C$, 
starting at position X. 


Return Y if stop system has been requested, N if stop system has 
not been requested. 


Return a character representation of the number X. 
Return the time of day in the form, HH:MM:SS. 


Convert lowercase letters in character string A$ to uppercase. 
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Module 


Name 


Function 


Descriptive Name 


#BL10 


#BL11 
#BL12 


#BL13(L,S) 


#BL14 
#BL15 
#BL16 


#BL17 


#BL18(L,S) 


#BL19 


#BL1A\(L,S) 


#BL1B 


#BL1D 


#BL1E 


#BL1F 


#BL20(L,S) 


#BL21 
#BL22 
#BL23 
#BL24 
#BL25 
#BL26 
#BL28 


#BL29 


B-6 


UPSIS$(A$) intrinsic function 


WSID$ 

ABS(X) intrinsic function 
ATN(X) intrinsic function 
CEIL(X) intrinsic function 
CMDKEY intrinsic function 


CNT intrinsic function 


CODE intrinsic function 


COS(X) and SIN(X) intrinsic 
functions 


DATE intrinsic function 
DEG(X) intrinsic function 


ERR intrinsic function 


FILE(X) intrinsic function 


FILENUM intrinsic function 


FP(X) intrinsic function 
INF intrinsic function 
INT(X) intrinsic function 
IP(X) intrinsic function 
KLN(X,Y) intrinsic function 
KPS(X,Y) intrinsic function 
LEN(A$) intrinsic function 
LINE intrinsic function 


MAX(X1,X2,...Xn) intrinsic 
function 


MIN(X1,X2,...Xn) intrinsic 
function 


Return the UPSI switches as character strings of ones and zeros, as 
requested by character string A$. 


Return the work station ID of the current work station or session. 
Return the absolute value of X. 

Return the arctangent (in radians) of X. 

Return the smallest integer not less than X. 

Return the numeric value of the last enter or command key used. 


Return the number of items successfully processed by the last input 
or Output statement. 


Return the numeric representation of the UPSI switches. 


Return the sine or cosine of X. 


Return the current date as a number in the form YYDDD. 
Return the number of degrees in X radians. 


Return the number of the error when an error occurs during program 
execution. 


Return the status (not opened, last operation successful, EOF during 
input, EOF during output) for file N. 


Return the file reference number of the last file in which an error 
occurred. 


Return the fractional part of X. 

Return the largest positive number representable in BASIC. 
Return the largest integer not greater than X. 

Return the integer part of X. 

Return the key length of Y-key part of file X. 

Return the key position of Y-key part of file X. 

Return the length of the string A$. 

Return the line number of the last statement with an error. 


Return the maximum value of X1, X2,...Xn. 


Return the minimum value of X1, X2,...Xn. 
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Module 
Name 


#BL2A 
#BL2B 
#BL2BA 


#BL2C(L,S) 
#BL2D 


#BL2E(L,S) 
#BL2F 
#BL30 
#BL31 
#BL32(L,S) 


#BL33(L,S) 
#BL35(L, S) 
#BL36(L,S) 


#BL37(L,S) 
#BL38(L,S) 
#BL39 
#BL3A 
#BL3B 


#BL3C 
#BL3D(L,5) 
#BL3E 
#BL3F(L,S) 


#BL40 
#BL41(L,S) 


#BL42 


#BL43 
#BL44 
#BL45 
#BL46 


Descriptive Name 


MOD(X,Y) intrinsic function 


ORD(AS$) intrinsic function 


ORD(AS$) intrinsic function for 


a given collating sequence 
Pl intrinsic function 


POS(A$,B$,X) intrinsic 
function 


RAD(X) intrinsic function 
REC(X) intrinsic function 
REM(X,Y) intrinsic function 
RLN(X) intrinsic function 


RND(X) intrinsic function 


SGN(X) intrinsic function 
SQOR(X) intrinsic function 


SRCH(A,X,N) intrinsic 
function 


SUM(A) intrinsic function 
TAN(X) intrinsic function 


TIME intrinsic function 


UDIM(A,N) intrinsic function 


UPSI intrinsic function 


VAL(X$) intrinsic function 
MAT A = AIDX(B) 
MAT A = CON 


MAT A = DIDX(B) intrinsic 
function 


MAT A = ZER 


ROUND(X,N) intrinsic 
function 


SRCH(A$,X$,N) intrinsic 
function 


UDIM(A$,N) intrinsic function 


MAT A =(X) or (X)*CON 
MAT A$ = (X$) 
MAT A=B 


Function 


Return X modulo Y. 
Return the ordinal position of A$ in the character set. 


Return the ordinal position of A$ in the character for the given 
collating sequence. 


Return the value of pi. 


Return the position of the first occurrence of B$ within A$ starting at 
position X. 


Return the number of radian in X degrees. 

Return the record number of the last record processed in file X. 
Return the remainder of X/Y. 

Return the record length of file X. 


Return a pseudo-random number between O and 1, using X as the 
seed value. 


Return the sign X. 
Return the square root of X. 


Return the position within the array A of X starting with element N. 


Sum all elements in the array A. 

Return the tangent value of X radians. 

Return the number of seconds since midnight. 

Return the upper subscript of the Nth dimension of array A. 


Return the number represented by a binary character string of ones 
and zeros. 


Return the number represented by X$. 
Set elements of array A to indexes of ascending values of array B. 
Set every element in array A equal to 1. 


Set elements of array A to indexes of descending values of array B. 


Set all elements of array A equal to O. 


Round X to the Nth digit. 


Return the position within array A$ or X$, starting with element N. 


Return the upper subscript of the Nth dimension of array A$. 
Set every element of array A equal to X. 
Set every element of array A$ equal to X$. 


Set each element of array A equal to the corresponding element B. 
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Module 


Name 


#BL47 


#BL48 


#BL4A 


#BL4B 
#BL4C 
#BL4D 


#BL4E 
#BL4F 


#BL50 
#BL51 


#BL52 
#BL53 


#BL54 


#BL55 


#BL56 


#BL58 


B-8 


Descriptive Name 
MAT A$=B$ 

MAT A=B+C 

MAT A=B-C 

MAT A=(X)*B 


MAT A = AIDX(B$) 
MAT A = DIDX(B$) 


CNVRTS$(A$,X) intrinsic 
function 


HEX$(A$) intrinsic function 
PIC$(A$) intrinsic function 


MSG$(X,A$) intrinsic function 


PROCIN intrinsic function 


PROCLVL intrinsic function 
RETCODES$ intrinsic function 


TIMER(A$) intrinsic function 


CURROW 


CURCOL 


USERID$ 


Function 


Set each element of array A$ equal to the corresponding element 
of BS. 


Set each element of array A equal to the sum or difference of the 
corresponding elements of arrays B and C. 


Set each element of array A equal to X times the corresponding 
element of array B. 


Set elements of array A to indexes of ascending values of array B$. 
Set elements of array A to indexes of descending values of array B$. 


Convert X to a character with the form shown in the form 
specification (A$). 


Convert A$ to its hexadecimal equivalent. 


Return the value of the floating currency symbol or change the value 
of the floating currency symbol to A$. 


Return the message with MIC value X from message member A$. 


Return O if input is from keyboard; return 1 if input is from a BASIC 
procedure. 


Return the number of BASIC procedures currently active. 


Return the value of the SSP-ICF return code for the last read or 
write to a work station or session. 


Set the system timer for a period of time given by the value of A$, in 
the form hhmmss; return O if successful, 1 if unsuccessful. 


Return the row position of the cursor when the last function key was 
pressed. 


Return the column position of the cursor when the last function key 
was pressed. 


Return a character string containing the user ID associated with the 
current program. 
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COBOL Directory 


COBOL COMPILER MODULES 


Compiler Descriptive 

Module Name Function 

#CBOO ROOT phase Main controlling phase for the COBOL compiler. 

#CBO1 TEXT phase Process source statements within the Identification, Environment, Data, and 
Procedure Divisions; process IGC literal. 

#CBO2 DTA1 phase Begin the processing of the Data Division, allocating space and displacements for 
level items and producing B-text for all statement numbers, errors, and edit 
pictures within this division. 

#CBO3 DTA2 phase Examine the syntax of the Identification and Environment Divisions. 

#CBO4 DLIT phase Generate literals and edit masks for the Data Division. 

#CBO5 PRO1 phase Begin processing of Procedure Division of B-text and perform special processing 
(reordering) of selected Procedure Division verbs. 

#CBO6 PRO2 phase Further reduce Procedure Division text, make entries in the Item Table for 
procedure names, and compute DMAX values for arithmetic statements. 

#CBO7 PRO3 phase Further reduce the Procedure Division B-text. Convert arithmetic and conditional 
expressions to reversed Polish strings and relational strings, respectively. 

#CBO8 GEN1 phase Process various Procedure Division statements and produce inline code or 
subroutine calls for address computation of subscripted, indexed, or linkage Section 
data names in all Procedure Division statements. 

#CBO9 GEN2 phase Process various Procedure Division statements. 

#CB10 GENS phase Process all arithmetic statements and relational statements. 

#CB11 GEN4 phase Complete the transformation of the Procedure Division to C-text. Optimize all code 
generated by the GEN1, GEN2, and GEN3 phases and eliminate all extraneous 
elements. 

#CB12 PLIT phase Process Procedure Division literals and external references. 

#CB13 OBJ phase Produce the object module from the external reference list, the Data and Procedure 
Division C-text, and the Literal text. 

#CB14 MAP phase Optionally provide Data Division and Procedure Division maps. 

#CB15 ERR phase Produce a listing of diagnostic messages and, optionally, a diagnosed source file. 

#CB16 END phase Terminate compilation and pass control to the system or to the overlay linkage 
editor. 

#CB50 COPY phase Process compiler control and COPY statements, and initiate diagnosed source file 
processing, if requested; process IGC literal in copy statement and copied text. 

#CB51 XREF phase Generate cross-reference listings for data names and procedure names. 

#CB54 DTA3 phase Examine the syntax in the Data Division and complete the Item Table entries for 
files. 

#CB55 PROA phase Scan all A-text for the Procedure Division, generating any error messages that are 
necessary in B-text, and reduce Procedure Division A-text to B-text. 

#CB58 GENA phase Process various Procedure Division statements, primarily program control verbs and 
low-level |/O verbs. 

#CB99 DBUG phase Process CDEBUG process option for compilation. 
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COBOL EXECUTION-TIME SUBROUTINES 


Subroutine Descriptive 

Name Name Function 

@CBOO0O0 — Store arithmetic result in case of GIVING option, or IF or COMPUTE statement. 

@CBO010 — Test for sign condition and ON SIZE ERROR during addition or subtraction, and 
compare numeric fields. 

@CBO20 — Multiplication. 

@CBO30 — Division. 

@CBO040 — Exponentiation. 

@CBO50 — Process ndd. 

@CBO60 — Called by @CBO5O to convert zoned decimal arithmetic result to binary or binary 
data item to zoned decimal. 

@CBO70 — Called by @CBO5O to convert zoned decimal arithmetic result to packed decimal, or 
packed decimal item to zoned decimal. 

@CBO80 — Called by CBO5O to edit arithmetic result being stored in numeric edited field. 

@CB100 — Move numeric and alphanumeric fields. 

@CB110 — Move numeric and alphanumeric fields to edited fields. 

@CB120 — Move Boolean data items. 

@CB150 — Resolve addresses for indexed items. 

@CB200 — Compare alphabetic and alphanumeric operands. 

@CB210 — Compare index names. 

@CB220 — Test for numeric field. 

@CB230 — Test identifier for alphabetic characters (A to Z and blank). 

@CB240 — Test system switches represented by UPSI-n special names. 

@CB250 — Maintain a truth-value stack. 

@CB260 — Compare alphabetic and alphanumeric fields and operands. 

@CB270 — Compare Boolean data. 

@CB290 — EBCDIC to ASCII translate table; used when ASCII collating sequence is specified. 

@CB300 — Read consecutively from disk file, and write records consecutively to disk file. 

@CB310 — Write, read, update, and locate records to direct file on disk. 

@CB320 — Locate record, read sequentially, and write sequentially from indexed file on disk. 
Also update and delete records sequentially on indexed file. 

@CB330 — Randomly read, write, update, and delete an indexed file. 

@CB340 — Set file status in COBOL program. 

@CB350 — Determine if there is a USE procedure to be called. 

@CB360 — Perform transaction file |/O operations. 

@CB400 — Implement OPEN statement. 

@CB410 — Implement CLOSE statement. 

B-10 
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Subroutine Descriptive 

Name Name Function 

@CB420 — Perform the STOP ‘literal’ function, and perform the DISPLAY on the SYSLIST, 
REQUESTOR, and CONSOLE functions. 

@CB430 — ACCEPT input from the input stream, the requester’s work station, and the 
operator's console until the identifier is filled. 

@CB440 — Implement WRITE statement for printer files. 

@CB480 — Perform ACCEPT/DISPLAY LOCAL DATA AREA. 

@CB500 — Perform the GO TO... DEPENDING ON ‘identifier’ in segmented and 
unsegmented programs. 

@CB510 — Implement TRACE statement and save address of program’s READY/RESET switch 
tested by @CB510. 

@CB520 — Implement STOP RUN statement. 

@CB530 — Perform the ACCEPT FROM DATE, ACCEPT FROM DAY, and ACCEPT FROM 
TIME functions. 

@CB540 — Control all entry to independent segments, and perform branching between 
independent segments. 

@CB550 — Handle checkpoint processing for files described with RERUN clause. 

@CB570 — Perform the SET index 1 UP BY, DOWN BY, and TO ‘identifier’ functions, and the 
SET index 1 TO index 2 and SET ‘identifier’ TO index 2 functions. 

@CB580 — Calculate address of subscripted data items, and current length of a group item 
that contains a variable-length table. 

@CB590 — Implement EXHIBIT statement. 

@CBé600 — Issue object-time message and allow user to select step termination or job 
termination, and move record when request made for input operation on 
locate-mode file. 

@CB620 — Contain standard initialization code for all COBOL-generated programs. 

@CB650 — Initialize execution of STRING operation and pass description of output field and 
optional pointer field. Also pass delimiter description, and concatenate a string 
input field to the output field. 

@CBE660 — Initialize execution of UNSTRING operation, pass description and addresses of 
parameters. 

@CB680 — Initialize, select tallying or replacing, and pass target identifier description. 

@CB700 — Build specifications for sort and merge operations. 

@CB900 — Set up the DEBUG ITEM special register and invoke the USE procedure. 

CBSTOP — Test system status to see if system shutdown is in process. 

CBEMCR Interface with SUBR25 for enhanced support of the 1255 MCR. 

CBFTOD Provide time of day in timer units of 8.192 milliseconds. 

CBINST Insert shift-out and shift-in characters in the first and last position for IGC 
processing. 

CBMICR Interface with SUBRO8 for support of the 1255 MCR. 

CBREMV Remove shift-out and shift-in characters from the first and last position for IGC 


processing. 
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FORTRAN Directory 


FORTRAN COMPILER MODULES 


Compile-Time Descriptive 


Module 


#FORT 


#FOOOD 


#FOO1 


#FOO2 


#FOO3 


#FO04 


#FOO5 


#FOO6 


#FOO7 


#FO08 


#FOO9 
#FO10 
#FO11 


#FO12 
#FO13 
#FO14 
#FO15 


#FO16 
#FO17 
#FO18 


#FO19 


Name 


Root phase 


Debug module 


Phase 1 


Phase 2 


Phase 3 


Phase 4 


Phase 5 


Phase 6 


Phase 7 


Phase 8 


Phase 9 
Phase 10 
Phase 11 


Phase 12 
Phase 13 
Phase 14 
Phase 15 


Phase 16 
Phase 17 
Phase 18 


Phase 19 


Function 


Perform initialization, load processing phases sequentially, provide system 
interface, and build the FORTRAN communications area. 


Control the operation of the console debugging capability. 


Read control records and source statements, process options, check for 
statement continuations, list source program, process FORMAT statements, and 
process logical IF statements. 


Determine statement type, and insert statement terminators. 


Check validity of logical IF, check FORMAT statement, and process AT and 
TRACE statements. 


Set FORMAT usage, pack statements, process PROGRAM statements, and 
check first character of unit number for BACKSPACE, END FILE, REWIND. 


Process subprogram, IMPLICIT, and specification statements; check statement 
numbers; remove unnumbered CONTINUE statements; and process statement 
numbers. 


Process COMMON and GLOBAL variables, process SUBROUTINE and 
FUNCTION dummy arguments, check for type FUNCTION statements, process 
IMPLICIT statements, and process GENERIC. 


Process DIMENSION statements; process REAL, INTEGER, LOGICAL, and 
EXTERNAL variables; and identify variable modes. 


Process real constants, and convert real constants to single or double precision 
format. 


Process DEFINE FILE, BACKSPACE, END FILE, and REWIND statements. 
Process integer constants and variables, ASF definitions, and subscripts. 


Check syntax of DEBUG statement, create DED entries for INIT and SUBCHK 
variables, and convert FORTRAN subroutine names to internal routine names. 


Process DATA statements. 
Process FORMAT statements. 
Process subscript constants. 


Process IF, CALL, and statement function statements, and check record numbers 
in READ/WRITE statements. 


Process processor-supplied and GENERIC functions. 
Process READ, WRITE, FIND, GOTO, and EQUIVALENCE statements. 


Process CONTINUE, STOP, PAUSE, and END statements, and implied DO-loops 
in READ/WRITE statements. 


Process DO statements and subscripts, identify required library modules for DO 
statements, and generate scientific instructions for DO statements. 
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Compile-Time Descriptive 


Module 


#FO20 


#FO21 


#FO22 


#FO23 
#FO24 


#FO25 


#FO26 
#FO27 


#FO28 
#FO29 
#FO31 
#FO32 
#FO33 
#FO34 


#FO35 
#FO36 
#FO37 


#FO38 


#FO59 


#FO78 


Name 


Phase 20 


Phase 21 


Phase 22 


Phase 23 
Phase 24 


Phase 25 


Phase 26 
Phase 27 


Phase 28 
Phase 29 
Phase 31 
Phase 32 
Phase 33 
Phase 34 


Phase 35 
Phase 36 
Phase 37 


Phase 38 


Phase 59 


Phase 78 


Function 


Convert FIND, READ, WRITE, IF, GOTO, CALL statement function, and 
assignment statements into modified Polish notation; and process arithmetic and 
logical operations, and arguments for subroutine calls. 


Process generated temporary markers for subscripts, and position subscript 
information in the statement string. 


Generate scientific instructions for subscripts and for RETURN, GOTO, and 
computed GOTO. 


Generate scientific instructions for |/O statements. 


Generate scientific instructions for expressions in ASF, IF, CALL, assignment, 
and direct access |/O statements. 


Process CALL, IF, ASF, assignment, |/O statements, and I/O lists; identify 
required library modules; generate scientific instructions for IF statements and IF 
blocks; and generate scientific instructions for CALL statements and CALL 
blocks. 


Process DEBUG options in TRACE, DO, and labeled statements. 


Assign storage addresses to variables, calculate storage required for constants 
and blocks, and print variable map. 


Build unit table. 

Check symbol table for errors, and print all error messages. 

Create save areas, prologues, and epilogs, and allocate storage for text string. 
Process statement allocations, and print label MAP. 

Allocate and open $WORK, create OPTNS record, and create ESLs. 


Create load IAR instruction, and create text records for DATA statements and 
constants. 


Create text for all blocks. 
Create text records for DTFs. 


Create text records for all FORMAT statements and literal constants in FORMAT 
statements. 


Create text records for all executable code, DO blocks, unit table, END and /* 
records, close $WORK file, and invoke the overlay linkage editor. 


Compute |/O storage requirements, and identify required data management 
modules. 


Rearrange statement string. 


Appendix B: Programming Language Directory B-13 


This document contains restricted materials of IBM. LY21-0590-4 
©Copyright IBM Corp. 1983, 1984, 1985, 1986 


FORTRAN EXECUTION-TIME SUBROUTINES 


Execution- 

Time 

Subroutine Descriptive Name Function 

@FOA1D Commercial subroutine Convert A1 to decimal format. 

@FOB1 |/O control Contain DED operators, list references, and debug references. 

@FOB2 |/O control Control formatted |/O. 

@FOB3 1/O control Control unformatted |/O. 

@FOB4 |/O control Control list-directed I/O. 

@FOB8 |/O control Fill |/O buffer with blanks for formatted and list-directed |/O. 

@FOB9 |/O control Contain buffer control blocks for formatted, unformatted, and 
list-directed |/O. 

@FOBA 1/O control For list-directed |/O, check that data will fit in available buffer space. 

@FOBB 1/O control Handle any program terminal error. 

@FOBUG Service subprogram A dynamic execution-time debug subprogram. 

@FOCO Conversion Handle all conversions for the A-format code data on input. 

@FOC1 Conversion Handle all conversions for the A-format code data on output. 

@FOC2 Conversion Handle all conversions for the |-format code data on input. 

@FOC3 Conversion Handle all conversions for the |-format code data on output. 

@FOC4 Conversion Handle all conversions for the E-, D-, and F-format code data on input. 

@FOC5 Conversion Handle all conversions for the E-, D-, and F-format code data on 
output. 

@FOC6 Conversion Handle all conversions for the L-format data on output. 

@FOC7 Conversion Handle all conversions for the Z-format code data on output. 

@FOC9 Conversion Determine the length of a variable. 

@FOCA Conversion Convert a binary number to zoned decimal. 

@FOCE Conversion Handle all conversions for the L-format data on input. 

@FOCF Conversion Handle all conversions for zoned decimal data to REAL*4 or REAL*8. 

@FOCG Conversion Power of 5 table, multiplication, and division routines for conversion. 

@FOCH Conversion Handle all conversions of REAL*4 or REAL*8 to zoned decimal. 

@FOCMD Service subprogram Test whether a command key has been pressed. 

@FODCK Service subprogram Divide check test. 

@FODEC Commercial subroutine Convert decimal to A1 format. 

@FODIV Commercial subroutine Divide zoned decimal fields. 

@FODPK Commercial subroutine Convert zoned decimal to packed decimal fields. 

@FODSW Service subprogram Test address/data switches on CE panel, and test data switch 
indicators. 
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Execution- 


Time 


Subroutine 


@FODSY 


@FODO 
@FOD2 
@FOD3 
@FOD5 
@FOD6 
@FOD7 
@FOD8 


@FODWN 


@FOEO 


@FOEDT 


@FOFIL 


@FOFST 
@FOGET 
@FOIBT 

@FOICO 
@FOINO 


@FO10 
@FO12 
@FOI24 
@FO13 
@FO16 
@FO17 
@FO18 
@FO19 
@FOIA 
@FOIB 
@FOIC 
@FOID 
@FOM1 
@FOM2 
@FOMS5 


Descriptive Name 


Service subprogram 
Debug 
Debug 
Debug 
Debug 
Debug 
Debug 
Debug 
Service subprogram 


Scientific instruction set 
interface 


Commercial subroutine 
Commercial subroutine 
Service subprogram 
Commercial subroutine 
Commercial subroutine 
Commercial subroutine 
Service subprogram 
|/O interface 

|/O interface 
Commercial subroutine 
|/O interface 

|/O interface 

|/O interface 

|/O interface 

|/O interface 

|/O interface 

|/O interface 

|/O interface 

|/O interface 

Math library 

Math library 

Math library 


Function 


Handle full screen information. 

Control DEBUG facilities input and output. 
Handle TRACE output. 

Handle SUBCHK output. 

Handle INIT output. 

Handle SUBTRACE output. 

Handle traceback errors. 

Write DEBUG messages. 

Test system shutdown indicator. 


Interpret interface. 


Edit a field with a mask field. 
Fill an area with a specified value. 


Indicate errors in library routine or |/O conversions. 


Convert a numeric field in A1 format to a REAL*8 value. 


Test for bit on or bit off. 

Compare two zoned decimal fields. 

Invoke ROLLOUT/ROLLIN. 

Execute the scientific instruction |/O operator. 


Card |/O interface. 


Determine whether an integer is INTEGER*2 or INTEGER*4. 


Printer |/O interface. 

Direct access disk interface. 
Sequential disk interface. 
Sequential disk BACKSPACE interface. 
Sequential disk END FILE interface. 
Sequential disk REWIND interface. 
Close DTF open in UNITAB. 

Print DEBUG and errors. 

Display screen interface. 

Handle SIN/COS. 

Handle DSIN/DCOS. 

Handle LOG.. 
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B-15 


Execution- 
Time 
Subroutine 
@FOM6 
@FOM7 
@FOM8 
@FOM9 
@FOMA 
@FOMB 
@FOMC 
@FOMD 
@FOME 
@FOMF 
@FOMG 
@FOMH 
@FOMI 
@FOMJ 
@FOMK 
@FOML 
@FOMM 
@FOMN 
@FOMO 
@FOMOV 
@FOMP 
@FOMPY 
@FOMQ 
@FOMSG 
@FOOVF 
@FOPCK 
@FOPUN 
@FOPUT 
@FORED 
@FOSIG 
@FOSKY 
@FOSLE 
@FOSLT 


Descriptive Name 


Math library 

Math library 

Math library 

Math library 

Math library 

Math library 

Math library 

Math library 

Math library 

Math library 

Math library 

Math library 

Math library 

Math library 

Math library 

Math library 

Math library 

Math library 

Math library 
Commercial subroutine 
Math library 
Commercial subroutine 
Math library 

Service subprogram 
Service subprogram 
Commercial subroutine 
Commercial subroutine 
Commercial subroutine 
Commercial subroutine 
Commercial subroutine 
Service subprogram 
Service subprogram 


Service subprogram 


Function 


Handle DLOG.. 


Handle INTEGER**INTEGER exponentiation. 
Handle REAL**INTEGER exponentiation. 
Handle REAL*8**INTEGER exponentiation. 
Handle REAL**REAL exponentiation. 
Handle REAL*8**REAL*8 exponentiation. 
Handle 2**REAL exponentiation. 


Handle 2**REAL*8 exponentiation. 


Handle ARCTAN. 
Handle DTAN. 
Handle SORT. 
Handle DSORT. 
Handle ALOG. 
Handle DLOG. 
Handle ALOG10. 
Handle DLOG10. 
Handle EXP. 
Handle DEXP. 
Handle TANH. 


Move data from one area to another. 


Handle DTANH. 


Multiply two zoned decimal fields. 


Handle DMOD. 


Retrieve user message. 


Indicate exponent overflow or underflow. 


Convert A1 to A2 format. 


Punch a card. 


Convert a REAL*8 value to Al format. 


Read a card. 
Test or modify a sign. 


Enable command keys. 


Set four internal switches. 


Test the internal switches. 
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Execution- 


Time 


Subroutine 


@FOSVO 
@FOSV1 
@FOSYN 
@FOSO 
@FOS10 
@FOS20 
@FOS30 
@FOS35 
@FOS40 
@FOS60 
@FOS70 
@FOS80 
@FOS90 
@FOSAO 
@FOTMD 
@FOUNP 
@FOUPC 
@FOVO 
@FOV1 
@FOV2 
@FOV3 
@FOV4 
@FOV5 
@FOV6 
@FOV7 
@FOV8 
@FOVD 
@FOVE 
@FOVF 
@FOVI 
@FOVK 
@FOVL 
@FOVM 


Descriptive Name 


Service subprogram 
Service subprogram 
|/O interface 
Commercial subroutine 
Commercial subroutine 
Commercial subroutine 
Commercial subroutine 
Commercial subroutine 
Commercial subroutine 
Commercial subroutine 
Commercial subroutine 
Commercial subroutine 
Commercial subroutine 
Commercial subroutine 
Service subprogram 
Commercial subroutine 
Commercial subroutine 
Invoked execution 
Invoked execution 
Invoked execution 
Invoked execution 
Invoked execution 
Invoked execution 
Invoked execution 
Invoked execution 
Invoked execution 
Invoked execution 
Invoked execution 
Invoked execution 
Invoked execution 
Invoked execution 
Invoked execution 


Invoked execution 


Function 


Handle FORTRAN INVOKE statement. 

Handle DUMP and PDUMP. 

Handle input from the SYSIN device. 

Handle print for commercial subroutines. 

Check unit table. 

Handle SKIP and SPACE. 

Shift the element of an array. 

Set indicated bit to O or 1. 

Handle KEYBD and TYPER. 

Process parameters. 

Handle zoned decimal ADD and SUBTRACT. 
Process commercial subroutine arguments. 
Handle commercial subroutine ADD and SUBTRACT. 
Handle NCOMP/LCOMP. 

Return date and time of day. 

Convert packed decimal to zoned decimal. 
Convert A2 to A2 format. 

Handle the absolute value function IABS. 
Handle the absolute value function ABS. 

Handle the maximum value function MAXQ. 
Handle the minimum value function MINO. 
Handle the maximum value function MAX1. 
Handle the minimum value function AMIN1. 
Handle the maximum value function DMAX1. 
Handle the minimum value function DMIN1. 
Handle the truncation function AINTM and AINT. 
Handle the sign changes for floating-point numbers. 
Handle the change of sign function SIGN. 
Handle the change of sign function ISIGN. 
Handle the sign changes for INTEGER numbers. 
Handle the positive difference function DIM. 
Handle the positive difference function IDIM. 


Handle the STOP n statement. 
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Execution- 


Time 

Subroutine Descriptive Name Function 

@FOVN Invoked execution Handle the PAUSE n statement. 

@FOVP Invoked execution Handle the STOP EQOJ statement. 

@FOVQ Invoked execution Handle the precision decrease function SNGL. 
@FOVR Invoked execution Handle the precision increase function DBLE. 
@FOVS Invoked execution Handle the modulo arithmetic function AMOD. 
@FOVT Invoked execution Handle the modulo arithmetic function AMOD. 
@FOVU Invoked execution Handle the maximum value function AMAXO. 
@FOVV Invoked execution Handle the maximum value function MAX1. 
@FOVW Invoked execution Handle the minimum value function AMINO. 
@FOVX Invoked execution Handle the minimum value function MIN1. 
@FOWHL Commercial subroutine Convert a REAL*8 value to a whole number. 
@FOZNE Commercial subroutine Test and modify zones. 

B-18 


This document contains restricted materials of IBM. LY21-0590-4 
©Copyright IBM Corp. 1983, 1984, 1985, 1986 


RPG Directory 


RPG COMPILER MODULES 


Module 

Name Descriptive Name Function 

#AUTO Copy function Initialize the common area and read and list the source. 

#AUOOA Catalog source program Create a library member of the generated source program. 

#AU00B Diagnostic root phase Retrieve and print the error messages and associated 
headings. 

#AUOOC Output Specification Generator Generate output specifications for heading *AUTO lines. 

#AUOOD Output Specification Generator Generate output specifications for detail/total *AUTO 
lines. 

#AUOOE Output Specification Generator Generate output specifications for detail/total *AUTO 
lines. 

#AU002 Source sort Sort source into compiler order. 

#AU003 File table build Build file table for printer files. 

#AU004 Heading diagnostics Diagnose heading *AUTO lines. 

#AU005 Detail/total diagnostics Diagnose detail/total *AUTO lines. 

#AUO006 Field-end position Build field-end positions for detail/total *AUTO lines. 

#AU007 Calculation Specifications Generator Generate calculation specifications for detail/total *AUTO 
lines. 

#AU008 Root phase processor Perform root phase functions for #AUOOC, #AUOOD, and 
#AUOOE. 

#AUO009 RPG compiler input Build input for the RPG II compiler. 

H#RPEA RPG file description compression Process file description specifications. 

#RPEB RPG extension compression Process extension specifications. 

#RPEC RPG line counter compression Process line counter specifications. 

#RPEE RPG telecommunications compression Process telecommunications specifications. 

#RPE| RPG input compression Process input specifications. 

#RPEK RPG calculation compression Process calculation specifications. 

#RPEO RPG output compression Process output specifications. 

#RPEW RPG postcompression and initialization Perform compression cleanup. 

#RPFA RPG copy tables into compressions Process tables, arrays, entry points, and module names. 
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Module 
Name 


#RPG 
#RPGF 
#RPGG 


#RPGH 
#RPGI 
#RPGK 


#RPGL 


#RPGN 
#RPGP 


#RPGT 


#RPGU 


#RPGV 


#RPGW 
#RPGX 
#RPGY 


#RPGZ 
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Descriptive Name 


RPG compiler initialization 
RPG assign and check indicators 


RPG check calculation specifications 2 


RPG assign file name and |OCB 
RPG assign file name and DTF 


RPG check telecommunications 
specifications 1 


RPG check telecommunications 
specifications 2 


RPG build DTFs 


RPG build extension, WSID table, and 
TDATA for WORKSTN 


RPG assign |/O areas (nondisk devices: 


CONSOLE, CRT, PRINTER, BSCA, 
KEYBORD, SPECIAL) 


RPG build name table 


RPG check table/array 


RPG check name table 
RPG print name table 


RPG build compile-time tables /arrays 


RPG compile-time table/array code 


Function 


Process control specifications. 
Assign and check indicators. 


Check calculation specifications, and compress and set 
specifications. 


Process file input/output table and I|OCB addresses. 
Process file input/output table and DTF addresses. 


Check errors in file name, ITBs, station IDs, and ASCII, 
and build and update tables. 


Check for errors in fields. 


Build 1|OCBs and preopen DTFs. 


Generate WSID table, TDATA hold areas, space for 
FORMAT directory, and TIND save and restore logic. 


Assign shared |/O areas, IOBs, and |/O buffer; generate 
object code and place addresses into |OCB and DIF. 


Build name table of compile-time and object-time 
tables/arrays and data structures. 


Check elements in table/array and write and delete data 
structure entries from name table. 


Check and set bits on in table. 


Build compile-time symbol table of compile-time 
table/array entries and DTT records. 


Generate object code blocks. 
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Module 
Name 


#RPHA 
#RPHB 
#RPHC 
#RPHD 


#RPHO 


#RPHS 
#RPHT 


#RPHU 
#RPHW 


#RPIC 
#RPIG 


#RPJA 
#RPJE 
#RPJG 
#RPJJ 


#RPJK 
#RPJL 
#RPJM 
#RPJN 
#RPJO 
#RPJP 
#RPJU 
#RPJW 
#RPJX 
#RPJY 


#RPJZ 
#RPKA 


Descriptive Name 


RPG build symbol table 
RPG build symbol table (DEFN processing) 
RPG check symbol table 


RPG print symbol table 


Function 


Build symbol table of field names. 
Add DEFN field names to symbol table. 
Set bits on and assign 2-byte addresses. 


Scan table and compressions for unreferenced and 


undefined names and write names. 


RPG assign alternate collating sequence 
and file translation tables 


RPG check input specifications 2 


RPG assign field hold areas and edit 
patterns 


Assign limits file hold areas 


RPG initialize allowable formats for 
CONSOLE device 


RPG postcompression initialization 


RPG check file description continuation 
records 


RPG check input specifications 1 
RPG check calculation specifications 1 
RPG check calculation specifications 3 


RPG control field and match field move 
optimization 


RPG check file and table/array 

RPG check calculation specifications 4 
RPG check output specifications 1 

RPG check output specifications 2 

RPG check output specifications 3 

RPG check input specifications 3 

RPG check compile-time tables / arrays 
RPG check file description specifications 1 
RPG check file description specifications 2 


RPG check extension and line counter 
specifications 


RPG check file description specifications 3 


RPG error sort, print, and error message list 
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Module 


Name Descriptive Name Function 

#RPKB RPG diagnosed source file build 

#RPLB RPG output indicator optimization 

#RPLG DTF parameter assign 1 

#RPLJ RPG preassemble calculations 3 

#RPLN RPG constant, literal, edit word assign | 

#RPLR RPG constant, literal, edit word, DTF 
parameter assign || 

#RPLV RPG output fields move optimization 

#RPLZ RPG output indicator testing 

#RPMA RPG output object code block length 

#RPMB RPG preassemble calculations 1 

#RPMH RPG preassemble calculations 4 

#RPMI RPG preassemble indicator optimization 

#RPMK RPG build segment list 

#RPMM RPG output segment list entries build 1 

#RPMN RPG output segment list entries build 2 

#RPMP RPG build calculation segment list 

#RPMQ RPG complete calculation segment list 

#RPPA RPG generate IPCR 

#RPPB RPG generate OPCR 

#RPPC RPG input mainline code 

#RPPE RPG build input record recognition code 

#RPPG RPG file selection and match field 
extraction code 

#RPPJ RPG control field extraction code 

#RPPL RPG lookahead field extraction code 

#RPPM RPG input field extraction code 

#RPPN RPG chain and read files code 

#RPPO RPG LR and overflow control mainline code 

#RPPS RPG output record code 

#RPPU RPG output fields 1 code 

#RPPV RPG output fields 2 code 

#RPPW RPG output fields 3 code 

#RPOA RPG operation independent calculations 
code 
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Module 
Name 


#RPOB 
#RPQC 
#RPOD 
#RPOE 
#RPOF 
#RPOG 
#RPQH 
#RPOK 
#RPOL 
#RPOT 
#RPOV 
#RPRA 
#RPRC 
#RPRW 
#RPRX 
#RPRY 
#RPRZ 


#RPZY 
DRGCFI 
DRGCZA 
DRGCZC 
DRGCZE 
DRGCZG 
DRGCZH 
DRGCZK 
DRGCZM 
DRGCZN 
DRGCZP 
DRGCZZ 
PIOCS 


Descriptive Name 


RPG calculations code 3 

RPG calculations code 1 

RPG calculations code 4 

RPG calculations code 5 

RPG calculations code 6 

RPG calculations code 7 

RPG calculations code 2 

RPG calculations code 8 

RPG calculations code 9 

RPG calculations code 10 

RPG calculations code 11 

RPG initialization and close code 
RPG table load/table dump code 
RPG chain and read files move field code 
RPG initialize segment list 

RPG library of subroutines code 


Form R-dot RPG code from segment list 
and object code 


RPG dump control facility 

RPG find item in compression (#RPIC) 
RPG open a compression area (#RPG) 
RPG write a compression (#RPG) 

RPG close a compression area (#RPG) 
RPG open a compression block (#RPIC) 
RPG get next compression (#RPIC) 
RPG close a compression block (#RPIC) 
RPG write an object code block (#RPIC) 
RPG get next source record (#RPG) 
RPG printer control (#RPG) 

RPG call next compiler phase (#RPG) 
RPG disk control (#RPG) 
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RPG EXECUTION-TIME SUBROUTINES 


Subroutine 

Name Descriptive Name 

$$SYRP RPG II halt processor 

#RPSPD Delete held print files 

#RPDD Data dictionary test 

@PGAA Array index 

@PGAB File translation 

@PGAC Square root 

@PGAS Array sort 

@PGBB BSCA logic for transmit 
and receive 

@PGBG BSCA logic for retrieve 

@PGBI Convert to binary 

@PGBO Convert to decimal 
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Function 


Called by the supervisor whenever a halt is requested by an RPG II 
compiler phase or RPG II object program. This is a transient. When an 
error occurs, $$SYRP is called and sets up a parameter list to be 
passed to the system log transient in the supervisor. For a description 
of errors, error codes, and console displays, see IBM System/36 RPG I! 
Messages Manual, SC21-7940. 


Called by the RPGONL procedure if the user does not want to see the 
RPG Il compiler listing. This module deletes the spool queue entry for 
the compiler listing. 


Called by RPGC, AUTO, and RPGONL procedures to determine if a data 
dictionary exists. 


Retrieve the address of the nth field in an array in which n is the value 
of the index in an input, calculation, or output specification. This 
subroutine is used when a specified element in an array is required. 


Replace characters in an entry in the translation table. The first 
character of each 2-byte element in the table is compared against the 
input data in the input buffer. When a comparison is found, the second 
byte of the translation table is replaced by the first byte. For output, the 
first byte of the translation table is replaced by the second byte. 


Find the square root of any zoned decimal number with or without 
decimal places by finding the number of significant digits in the source 
and squaring successively smaller numbers until the exact root is found. 
The result is automatically half adjusted. 


Sort the array specified into ascending or descending order, depending 
on how the array was defined. 


Place the table element address into the BSCA preopen DTF, if the 
table element address was specified for the dial number or station IDs 
on the telecommunications specifications. Translate station IDs using 
the translation table, if file translation was specified for the BSCA file. 


Place the table element address into the BSCA preopen DTF, if the 
table element address was specified for the dial number or station IDs 
on the telecommunications specifications. Translate station IDs to ASCII 
by using the translation table, if ASCII was specified. 


Convert a decimal number to its binary equivalent. 


Convert a binary number to its decimal equivalent. (The length will be 
either hex 04 or hex 09, depending on the size of the field specified in 
the extension or input specifications. If the size is 2 bytes binary, the 
length will be hex O9. If the number is larger than the number that can 
be contained in 4 bytes, only the overflow portion is shown.) 
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Subroutine 
Name 


@PGBP 


@PGBS 


@PGCI 


@PGCO 


@PGCR 


@PGDC 


@PGDI 


@PGDM 


@PGFI 


@PGFO 


@PGIC 


@PGLC 


@PGMA 


Descriptive Name 


BSCA logic for transmit 


BSCA SVC data 
management router 
Unpack 


Pack 


KEYBORD/CRT data 
management 


DEBUG 


Alternate collating 
sequence 


SVC data management 
router 


Load object tables 


Dump object tables 


Divide 


LOKUP 


Move array 


Function 


Replace the table element address into the BSCA preopen DTF if the 
table element address was specified for the dial number of station IDs. 
Translate station IDs to ASCII by using the translation table, if ASCII 
was specified. 


Call the data management router to get or put to the BSCA file. 


Convert a packed decimal field with a maximum length of 8 bytes to a 
signed unpacked decimal field up to 15 bytes long. 


Convert an unpacked field up to 15 bytes long into a packed field with 
a maximum length of 8 bytes. The sign is maintained. 


Determine the type of operation requested and builds the appropriate 
5250 text stream. Issue the |/O request to work station data 
management. Check the validity of the command keys that are pressed 
with the SET operation. Position the keyed data in the RPG field for the 
KEY operation. 


Produce either one or two records, depending upon the parameters 
passed by the object code generated in the #RPOQV compiler phase. 
One record contains a list of all indicators that are on at the time the 
DEBUG operation code was encountered. The second record shows the 
contents of any one field, array, array element, or table element. 


Compare two alphameric field when one or both are not in normal 
collating sequence. 


Call the data management router to get or put to all files other than 
BSCA. 


Load any preexecution-time table/array and its alternate into storage 
and perform sequence checking. 


Dump object-time table/array and its alternate onto the appropriate 
device at last record (LR) time, if the extension specification for this 
table/array has a to-filename entry specified. 


Divide two numbers in the prime work area of ROCA and leave the 
quotient and remainder in the prime work area in case an MVR 
operation code follows. 


Compare a field or search argument against the entries in a given table 
or array, until a specified setting of the condition register results, and 
return the address of the table/array element that caused the register to 
be set. 


Move data from a field to an array, from an array to a field, or from an 
array to an array. If an array if variably indexed, this subroutine 
calculates the address of the indexed element. Data is moved from 
factor 2 to the result field; the length of the move is the shorter of the 
lengths of factor 2 and the result field. If factor 2 is a figurative 
constant, it fills the array from the referenced array element to the last 
element in the array. 
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Subroutine 


Name Descriptive Name Function 
@PGMC Multiply Multiply the two integers in the prime work area in ROCA. 
@PGRI Indicators Set specified resulting indicators on or off as required by the object 
program. 
@PGTA CONSOLE data Determine and display the current record format on the display station 
management display screen. Process the CONSOLE record keyed by the display 
station operator. 
@PGTC Test zone Test the zone of a byte loaded into the prime work area and sets the 
condition register. 
@PGTD Work station return code Update *STATUS and data managment return codes on input, output, 
update NEXT, ACQ, and REL operations. 
@PGTI Work station input Obtain an input record for the object program from the WORKSTN file. 
processing Scan the work station ID table to establish control information for the 
WORKSTN file. Save data and indicators for the currently active work 
station. Process errors encountered by a work station. If a WORKSTN 
INFSR error/exception subroutine is specified, exit to the subroutine 
when an error condition occurs or when a function key is pressed. 
@PGTL CONSOLE limits data Display the limits prompt on the display station display screen. Process 
management the low and high limits entered by the display station operator. 
@PGTO Work station output Invoke work station data management to perform a put or release 
processing operation. Schedule an invite input operation for multiple work station 
files or for requestors. Initialize a work station that has not undergone 
startup input processing. If a WORKSTN INFSR error/exception 
subroutine is specified, exit to the subroutine when an error condition 
occurs. 
@PGTP Work station allocation Invoke work station data management to allocate (acquire) a work 
(ACQ) station for the object program. Create a new work station identification 
table entry. If a WORKSTN INFSR error/exception subroutine is 
specified, exit to the subroutine when an error condition occurs. 
@PGTR Work station deallocation Deallocate (releases) a work station from the object program. Halt if 
(REL) entry for work station to be released cannot be found. Delete work 
station identification table entry. If a WORKSTN INFSR error/exception 
subroutine is specified, exit to the subroutine when an error condition 
occurs. 
@PGTS Work station scan Scan work station ID table for one of these types of entries: 
e A specified work station ID entry 
e Any work station ID entry 
« A null entry 
@PGTT Work station retrieve Invoke work station data management to retrieve display station status 
display station information information. The status information is display station size (1920 or 
post 3564). 
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Subroutine 


Name Descriptive Name Function 
@PGTU Select next input work Select a work station (of a multiple work station file) from which to 
station receive the next input record. If a WORKSTN INFSR error/exception 
subroutine is specified, exit to the subroutine when an error condition 
occurs. 
(@PGO1 Read SYSIN Read one 120- or 512-byte record each time the subroutine is called. 


Set the end-of-file indicator when the END statement is encountered. 
@PG20 Get/put external indicators Swap the external indicators between the specified display station's 

local communication area and the ROCA indicator table. 

Return results in the RPG field specified in the RLABL parameter list. 
@PG21 Get/put local Swap data between the local communication area for a specified display 


communications area station and an RPG II field or data structure. 


Return results in the RPG II field specified in the RLABL parameter list. 


@PG22 Read and update work For the first read or when a restart option, read the first logical record 
station utility transaction from the chain specified by the parameter list array. 
file 


For a normal get operation, read the next logical record in the chain 
and, if last record, return a last record indication to RPG. 


When the close option is specified in the special DTF, close the WSU 
transaction file and return to RPG. 


When an error condition is found, turn on appropriate indication in the 
parameter list array and return to RPG. 


@PG23 Message retrieve Retrieve messages from user-specified message member. The 
subroutine maximum length of a level-1 message is 75 characters; the maximum 
length of a level-2 message is 225 characters. 


@PG40 Remove S/O and S/!| IGC Move the from-field to the to-field and remove the shift-in and 
control characters shift-out characters from the first and last positions of the from-field. 
Set a return code indicating the status of the move. 


@PG41 Insert S/O and S/I IGC Move the from-field to the to-field and insert the shift-in and shift-out 
control characters characters from the first and last positions of the from-field. Set a 
return code indicating the status of the move. 


@PG95 Inline inquiry support Turn on an indicator passed in the parameter list if an inquiry request if 
pending. Turn off the inquiry request bit in system communications area 
before returning. 


Appendix B: Programming Language Directory B-27 
This document contains restricted materials of IBM. LY21-0590-4 
©Copyright IBM Corp. 1983, 1984, 1985, 1986 


This document contains restricted materials of IBM. LY21-0590-4 
©Copyright IBM Corp. 1983, 1984, 1985, 1986 


Appendix C: Program Product Utilities Directory 


This appendix provides brief descriptions of program 
product utilities modules. It contains module/routine 
descriptions for modules in the the following program 
product utilities: 


¢ Data file utility (DFU) 

¢« Screen design aid (SDA) 

¢ Source entry utility (SEU) 

¢ Work station utility (WSU) 

¢ lIdeographic sort utility 

e Ideographic character generator utility 

¢ Query/36 

« PS/36 

¢« DW/36 

e Development Support Utility (DSU) 

Use this appendix when diagnosing problems relating to 
the IBM program product utilities and any code 
generated by utilities within it. 

All modules listed in this appendix, with the exception of 
WSU modules, are execution-time modules. The 
modules listed under WSU compile-time modules are the 
modules that comprise the WSU compiler; the modules 
listed under WSU execution-time modules are those that 


are either part of the user's WSU object program or are 
available to the user's object program. 
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Data File Utility (DFU) Program Product Directory 


Module Name 


Descriptive ‘Jame 


Function 


#DFDE 


#DFDI 
#DFDU 


#DFEI 


#DFEU 


#DFEX 


#DFFB 


#DFIN 


#DFLS 


#DFMP 


#DFQE 


#DFQI 


#DFQOL 


#DFSB 


#DFSS 


#DFUD 


#DFUP 


#DFWS 


DFU enter/update mainline—entry 
and insert modes 


DFU diagnose specifications 


DFU enter/update 
mainline—update mode 


DFU enter/update mainline—entry 
and insert modes 


DFU-—enter/update mainline 
subroutines 


DFU initialize 
enter /update /inquiry /list 
execution 


DFU create format in DFU work 
file 


DFU inquiry execution 


DFU list execution 


DFU build attributes specifications 


DFU create enter/update DFU 
specifications 


DFU create inquiry DFU 
specifications 


DFU create list DFU specifications 


DFU build source input for sort 
portion of DFU list 


DFU save DFU specifications 
source 


DFU enter/update 
mainline—update mode 


DFU update DFU specifications 


DFU create work station source 
specifications 


Prompt operator for new record data in sequential or direct file. 
Build record and write to file. 


Diagnose DFU specifications. 


Prompt for the review or edit of the previous record processed 
in a sequential or direct file. 


Prompt operator for key and data fields for a new record in an 
indexed file. Build record and write to file. 


Retrieve the first enter/update mainline driver phase. Contains 
the following subroutines: update and display batch and total 
accumulators; allocate printer; print new, updated or deleted 
records; and process operator requested end of job. 


Read and process DFU control statements; allocate new file for 
enter function; initialize job execution area (COMMON) for 
update, inquiry, and list functions; route control to the 
execution module to process the file. 


Create the file, record, and field information sectors for the 
DFU format and write them in the work file. 


Process user requests interactively in displaying indexed 
sequential or direct data file records at the display station. 


List the data file in the format specified by the DFU program. 


Find and retrieve records from the source member containing 
the file definition and input specifications. Allocate and open 
temporary data file for the diagnosed DFU attributes. 


Prompt operator for information required to build DFU 
specifications needed to process an enter/update request. 


Prompt operator for information required to build DFU 
specifications needed to process an inquiry request. 


Prompt operator for information required to build DFU 
specifications needed to process a list request. 


Create a source member of sort sequence specifications for the 
data file to be listed. 


Prompt for options and perform source save. 


Prompt for the review or edit of the previous record processed 
in an indexed file. 


Display, print, and/or allow for the editing of DFU 
specifications. 


Create work station source specifications for enter/update and 
inquiry jobs, and write the DFU format as a SUBR library 
member. 
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Screen Design Aid (SDA) Utility Directory 


Module Name 


Descriptive Name 


Function 


HSAEF 


#SAEM 


#SAEP 


HSAER 


HSAEW 


HSAFA 


#SAFU 


#SAIN 


#SALB 


#SAMM 


#SAPF 


#SAPM 


#SAPR 


#SAPW 


#SASC 


H#SASE 


HSASF 


SDA format termination 
processing 


SDA menu termination 
processing 


SDA print termination 
processing 


SDA RPG termination 
processing 


SDA WSU termination 
processing 


SDA screen format add 
processing 


SDA screen format 
update /copy processing 


SDA initialization 


SDA librarian 


SDA menu modification 


SDA screen format processing 


SDA menu processing 


SDA RPG generation 
processing 


SDA WSU generation 
processing 
SDA compiler selection 


SDA edit selection 


SDA screen format selection 


Process end-of-member-options display; copy format member in 
primary work file to source library. 


Process end-of-menu-options display; copy menu members in 
primary work file to source library. 


Process end-of-print-options display; print formats from format 
member in primary work file. 


Process end-of-RPG-generation-options display; copy RPG 
WORKSTN specifications in secondary work file to source library. 


Process end-of-WSU-generation-options display; copy the WSU 
program in secondary work file to source library. 


Perform ADD and READD format operations using secondary 
work file; perform recovery processing On secondary work file; 
process end-of-format-options display. 


Perform UPDATE and COPY format operations using secondary 
work file; perform recovery processing on secondary work file; 
process end-of-format-options display. 


If SDA primary work file exists, show the recovery options 
display; initialize the LDA. 


Service requests from selection routines for a member name list. 


Process menu definition work displays and update text(s) in 
secondary work file for user modifications to command and 
display text or help text; process end-of-text-options screen. 


Perform mainline processing for the building of a secondary work 
file for ADD, RGADD, COPY, and UPDATE operations on a 
particular format. 


Build secondary work file for text editing, translating System /34 
type display text to System /36 menu text if necessary. 


Build secondary work file for RPG program generation. Prompt 
for and process RPG program definition displays. 


Build secondary work file for WSU program generation. Prompt 
for and process WSU program definition displays. 


Process recovery on primary work file and user selection of source 
member to compile. 


Process recovery on primary work file and user selection of source 
member for SEU editing. 


Provides the following functions: 


e Process recovery on primary work file and user selection of 
format source member 


e Prompt for user selection of screen formats and user selection 
of ADD, UPDATE, DELETE, RESTORE, or PATTERN AFTER 
screen format operations 
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Module Name 


Descriptive Name 


Function 


#SASM 


#SASO 


#SASP 


#SASR 


#SASV 


#SASW 


#SAS1 


#SAS2 


#SAS3 


#SAS4 


SDA main option menu 
processor 


SDA screen format print 


SDA selection for RPG 
program selection 


SDA screen format view 
selection 


SDA selection of WSU 
program generation 


SDA S specification syntax 
checker 


SDA D specification syntax 
checker 


SDA D specification servicing 


SDA D specification syntax 
checker 


SDA menu selection provides the following functions: 


e Process recovery on primary work file and user selection of 
menu source members 


e Prompt for menu texts within a menu source member and user 
selection of ADD, UPDATE, DELETE, or PATTERN AFTER text 
operations 


Service user’s menu selection requests for the 
following: 


e Create or update a menu and its help text 


e« Create, add, update, delete, and copy formats for the screen 
format generator 


¢« Create, add, update, delete, copy formats for WSU 
¢ Build RPG Il WORKSTN file specifications 

e Build a WSU program 

e Edit source members via SEU 

« View screen formats in a $SFGR load member 

e Print images of screen formats in a source member 


e Evoke the screen format generator 8 to compile screen 
formats 


Process recovery on primary work file and user selection of a 
format source member. Initialize primary work file. Process user 
selection of screen formats within a format source member to 
print. 


Process recovery on primary work file and user selection of source 
members. Initialize primary work file. 


Process recovery on primary work file and user selection of format 
load member. Initialize primary work file. Process user selection 
of screen formats within a format load member to view. 


Process recovery on primary work file and user selection of source 
member. Initialize primary work file. 


Perform syntax checking on S specifications. 
Perform syntax checking on D specifications. 
Move data between work screen image and D specification 


constant area. 


Perform syntax checking on WSU D specifications. 
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Source Entry Utility (SEU) Directory 


Module Name 


Descriptive Name 


Function 


#SEAN 


#SEDL 


#SEDX 


H#SEEJ 


#SEEO 


#SEET 


#SEIC 


#SEID 


#SEIN 


#SELL 


#SEMV 


#SEMX 


#SERA 


#SERB 


SEU scan 


SEU delete 


SEU data management 
operations for delete, count, 
and add index sector function 


SEU end of job 


SEU end-of-job option and 
command key display 


SEU enter/update 


SEU include 


SEU include II 


SEU initialization 


SEU roll 


SEU move 


SEU message translate 


SEU RPG II optional 
calculation specification 
syntax checker—phase 3 


SEU RPG II optional 
calculation specification 
syntax checker—phase 2 


Scan a member for a statement that contains a specified 
character string and optionally replace the string with another 
specified character string. 


Delete statements from the current member. 


Response check for all statement numbers, delete a statement by 
removing index entry, count number of statements between the 
from statement and the ending statement for move operation, get 
new index sector when required and chain to previous and next 
sectors. 


Copy statements from the SEU work file to the library member 
and perform statement serialization, program name duplication, 
and member listing as requested. Delete work file. 


Allocate a printer to SEU if printing is requested, change number 
of display screen lines per statement, display the command 
function key display, and prompt for end-of-job options. 


Enter statements into the member or update statements that 
already exist in the member. Retrieve selected display screen 
formats. If print option is on, use printer data management 4 | to 
print statements. 


Include statements from another member into the current 
member. Perform roll up and search-end-of-source functions for 
include members. If print option is on, use printer data 
management 4 | to print statements. 


Check responses to Include-From-Library-Name, and 
Include-From-Member-Name prompts. Change roll factor. 


Initialize variables and diagnose the SEU control statements. If it 
already exists, copy the member being worked on into the work 
file from the library. 


Perform roll up, roll down, and search-end-of-source functions 
on all members except include member. 


Copy or move specified statements from one location to another. 
If move was specified, delete statements at original location. 


Allow the user to enter translated versions of messages that are 
contained in a message source member. 


Continue RPG II calculation specifications syntax checking. 


Continue RPG II calculation specifications syntax checking. 
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Module Name 


#SERC 


#SERD 


#SERE 


#SERF 


#SERG 


#SERH 


#SERI 


#SERJ 


#SERL 


#SERO 


#SERP 


#SERT 


#SERU 


#SEU 


Descriptive Name 


SEU RPG II optional 
calculation specification 
syntax checker—phase 1 


SEU RPG II optional 
calculation specification 
‘syntax checker—phase 4 


SEU RPG II extension, line 
counter, copy statement, auto 
report, and control card 
specifications syntax 
checker—phase 1 


SEU RPG II file description 
specification syntax 
checker—phase 1 


SEU RPG II file description 
specification syntax 
checker—phase 2 


SEU RPG II file description 
specification syntax 
checker—phase 3 


SEU RPG II input specification 
syntax checker—phase 1 


SEU RPG II input specification 
syntax checker—phase 2 


SEU RPG II extension 
specification syntax 
checker—phase 2 


SEU RPG II output 
specification syntax 
checker—phase 1 


SEU RPG II output 
specification syntax 
checker—phase 2 


SEU RPG II 
telecommunications 
specification syntax 
checker—phase 1 


SEU RPG II 
telecommunications 
specification syntax 
checker—phase 2 


SEU common 


Function 


Syntax check RPG II calculation specifications. 


Continue RPG II calculation specifications syntax checking. 


Syntax check RPG II control, extension and line counter 
specifications; and auto report option and /COPY specifications. 


Syntax check RPG II file description specifications. 


Continue syntax checking RPG II file description specifications. 


Continue syntax checking of RPG II file description specifications. 


Syntax check RPG II and auto report input specifications. 


Continue syntax checking RPG II and auto report input 
specifications. 


Continue syntax checking RPG II and auto report control, 
extension and line counter specifications; and auto report option 
and /COPY specifications. 


Syntax check RPG II and auto report output specifications. 


Syntax check RPG II and auto report output specifications. 


Syntax check RPG II and auto report telecommunications 
specifications. 


Continue syntax checking RPG II and auto report 
telecommunications specifications. 


Load the SEU local data area and the four main storage resident 
routines (SEUDM, SEUKEY, SEUMSG, and SEUPNT). 
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Work Station Utility (WSU) Directory 


WSU COMPILER MODULES 


Compile-Time 
Module 


#WSGAF 


#WSGAI 


#WSGAL 


#WSGAM 


#WSGAS 


#\WSGBF 


#WSGCD 


#WSGCH 


#WSGCS 


#WSGDS 


#WSGEP 


#WSGFO 


#WSGFS 


Descriptive Name 


WSU assign data base field 
values 


WSU indicator assignment 
phase 


WSU assign program label 
values 


WSU message assignment 
phase 


WSU build array 
specification area 


WSU field name table 
building phase 


WSU command data area 
building phase 


WSU control header building 
phase 


WSU command specification 
area building 


WSU data specification area 
building phase 


WSU execution procedure 
member generating phase 


WSU object program 
formatting phase 


WSU file specification area 
building phase 


Function 


Assign data base field values; place the JDB size, WDB size, and 
counts of data base fields, system fields, program labels, and 
subroutines in GCOMMON. 


Use local copy of system indicator table to update 
indicator-referencing T, M, S, D, and C records with the 
corresponding mask/displacements. Print indicator usage lists. 


Update field name table with relative command data block 
numbers and data block displacements for program labels. 


Update C records that have message-defining literals with 
assigned relative message numbers. Build MIC table and update 
C records that have message-referencing MIC numbers with 
assigned relative message numbers. Print list of referenced MICs. 


Generate array specification area (ASA) for the WSU object 
program. 


Build field name table from data field and program label 
definition/references on T, M, F, S, D, and C records. 


Format the command data area from C records, GCSBDFSB, 
GCSBDRSD, and GCSBDPSB and put the area in work file object 
at the preassigned location. 


Format the control header from sections of GCOMMON and put it 
in the first work file object sector. 


Format the command specification area for C records and put the 
area in the work file object at the preassigned location. 


Format the data specification area from T, M, F, S, D, and C 
records and the system fields table and put the area in the work 
file object at the preassigned location. 


Calculate the minimum execution region size. Format the 
execution procedure statements and put them in the new 
procedure member. Print an execution region map and the OCL 
for the new procedure. 


Build file and record type specification block displacement tables 
from T, M, |, and F records. Build a process segment 
specification block displacement table and table of display 
attributes and field counts from S and D records. Determine total 
object size and assign relative locations to individual object areas. 


Format the file specification area from T, M, |, and F records and 
put the area in the object work file at the preassigned location. 
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Compile-Time 


Module Descriptive Name Function 

#WSGLS WSU local specification area Format the local specification area from F records and put the 

building phase area in the object work file at the preassigned location. 

#WSGMD WSU message data area Format the local specification area from C records and put the 

building phase area in the object work file at the preassigned location. 

#WSGML WSU message length Build tables from D records that describe display screen format 

assignment phase field distribution. Determine the number of bytes allowed for 
message text on each display screen format. Update D records 
with assigned message lengths. Print extended diagnostics. 

#WSGMS WSU message specification Format the literal section of the message specification area from 

area building phase C records and put the section in the work file object at the 
preassigned location. Format the MIC section of the message 
specification area from C records and put the section in the work 
file object after the literal section. 

#WSGMT WSU diagnostic message text Print list of diagnostic message texts cross-referenced to error 

listing and cleanup phase numbers and severity codes. If an abort or terminal error has 
been signaled, abnormally terminate generation. 

#WSGOB WSU object program member Load /ibrary sector PUT /GET i and copy the preformatted work 

generating phase file object to the new object member. 

#WSGOM WSU generator post-assign Initialize the post-assign GCOMMON extension, overlaying 

initialization phase assign-only code and data. 

#WSGPS WSU process specification Format the process specification area from S records and 

area building phase GCSCRNTB and put the area in the work file object at the 
preassigned location. 

#WSGRF WSU field data block Update embedded field data blocks in T, M, F, S, D and C 

resolution phase records and system fields table with name definitions and relative 
number and displacement assignments from corresponding field 
name table entries. 

#WSGSS WSU screen specification Format the screen specification area from S and D records and 

area building phase GCSCRNTB and put this area in the work file object at the 
preassigned location. 

#WSGWEFE WSU generator post-syntax Initialize the post-syntax GCOMMON extension, overlaying 

initialization phase syntax-only code and data, and move a copy of the system fields 
table into GCOMMON. 

#WSGO WSU generator common Initialize the generator's common data areas (GCOMMON, 

initialization phase GCCHGEND, and GCSYNTAX). Print source records up to first 
noncomment or end of file. 

#WSGOI WSU generation initialization Initialize generator environment. Prime common data area with 
control information, open required files, and start WSU 
compilation listing. 

#WSG1 WSU J specification syntax Print J specification and read and print all source records to the 

checking phase first T, M, S, D, or C specification EOF. 

C-8 
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Compile-Time 


Module Descriptive Name Function 

#WSG2 WSU T and M specification, F Print records in source buffer and read and print T, M, F, and | 
and | specification syntax specifications and all source records to the first S, D, or C 
checking phase specification or end of file. Put T, M, |, and F records in the work 

file intermediate text. 

#WSG2A WSU E specification syntax Syntax check all E specification fields, build intermediate text 
checking phase entries and common data areas, write MICs for all errors 

detected. 

#WSG3A WSU S specification syntax Print record in source buffer and read and print S specifications 
checking phase and all other source records to first D or C specification or end of 

file. Put S record in work file intermediate text. 

#WSG3B WSU D specification syntax Print record in source buffer and read and print D specifications 
checking phase and all other source records to next C or S specification or end of 

file. Put D record in work file intermediate text. 

#WSG4A WSU calculation specification Begin checking the syntax of calculation specifications. Put 
syntax checker special C and/or S records in the work file intermediate text. 

#WSG4B WSU calculation specification Complete syntax checking for table operations. Print C 
operation, table, and specification and any continuation line and all other source records 
continuation syntax phase to next C, S, or D specification or end of file. Put C record in 

work file intermediate text. 

#WSG4C WSU calculation specification Complete syntax checking for message operations. Print C 
operation, MiC/message text, specification and read and print any continuation line and all other 
and continuation syntax source records to next C, S, or D specification or end of file. Put 
checking phase C record in work file intermediate text. 

#WSG4D WSU calculation specification Complete syntax checking for non-message/table operations. 
operation, factor 2, result field, Print C specification and read and print all source records to next 
and half-adjust syntax C, S, or D specification or end of file. Put C record in work file 
checking phase intermediate text. 

#WSG5 WSU file, record type, and Build relational tables for file, and record type definitions. Update 
processing level assignment C and S records with relative file and record type numbers and 
phase processing level codes. Print extended diagnostics. 

#WSG6 WSU format assignment Build relational tables for format definitions. Update C records 
phase with relative screen format numbers. Print extended diagnostics. 

#WSG8 WSU operation code Print unreferenced multiply-defined and undefined field names. 
assignment phase Print extended diagnostics. Adjust 

field-name-definition-dependent operation codes in C records. 

#WSG9 WSU SFGR source member Format SFGR S and D records and put them in a new source 


generating phase 


member. 
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WSU EXECUTION-TIME MODULES 


Execution- 


Time Modules Descriptive Name 


#TXCR 


#TXC1 


#TXC2 


#TXC3 


#TXC4 


#TXC5 


#TXCE6 
#WSUCR 


#WSUEX 


#WSURV 


#WSXI1 


HWSXI2 


#WSXP 


WSU TXCR file build (CREATE) 
mainline 


WSU TXCR end statement 
processor 


WSU TXCR recover statement 
processor 


WSU TXCR refresh end 
statement processor 


WSU TXCR recreate statement 
processor 


WSU TXCR txcrfile statement 
processor 


WSU TXCR run processor 


WSSU transaction file create 
routine 


WSU transaction file extraction 
routine 


WSU recovery extraction 
routine 


WSU execution initialization 
phase 1 


WSU execution initialization 
phase 2 


WSU execution process 
mainline 


Function 


Initialize for TXCR utility. 


Process TXCR END control statement. 


Process TXCR RECOVER control statement. 


Process TXCR REFRESH control statement. 


Process TXCR RECREATE control statement. 


Process TXCR TXCRFILE control statement. 


Process TXCR RUN control statement. 


Build transaction file record-by-record. 


On transaction file record retrieval, selectively exclude retrieved 
records. 


On transaction-file-trailer-containing-file record retrieval, 
selectively exclude retrieved records. 


Initialize for WSU object program execution by finding required 
message, object program, and format members, and by 
intialization all required data areas. 


Allocate and open disk files, set up WSU execution work file 
according to information in object member, format common data 
areas. 


Perform the following execution-time subroutine processing: 


¢ Initial load low storage resident data/code. 
e Initialize low storage resident data areas. 


e Perform enter linkage for called subroutine and, if required, 
fetch subroutine-containing WSU transient. 


e« Perform return linkage for called subroutine and, if required, 
fetch calling-routine-containing transient. 


e Dispatch work session driver to complete, restart, or begin 
interaction cycle for work station, or work session abort to end 
cycle. 


e Abort job or session. 


e Process storage requests. 
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Execution- 
Time Modules Descriptive Name 


#WSXO0O WSU execution transient O 
#WSX01 WSU execution transient 1 
#WSX02 WSU execution transient 2 
#WSX03 WSU execution transient 3 
#WSX04 WSU execution transient 4 
#WSX05 WSU execution transient 5 
#WSX06 WSU execution transient 6 
#WSX07 WSU execution transient 7 
#WSX08 WSU execution transient 8 
#WSX09 WSU execution transient 9 
#WSX10 WSU execution transient 10 


Function 


Log driver trace entries, work station trace entries, and file trace 
entries. 


Read records from specified data file, and suspend session if 
necessary to avoid record contention. 


Write record to specified data file. 

Consists of routines for the following: 

¢« Trace pool element functions, if pool trace active. 
e Restore registers and return to caller. 


¢ Display specified WSU/user format and select any required 
messages. 


Process the RANGE operation for alphameric factors. 


Process all calculation specifications for the current processing 
segment. 


Consists of routines for the following: 


e Perform sign-on initialization of transaction file, session 
activation, and initiate the IJ, IW, and first sequence screen 
processing segments. 


e« Validate work session data record chain in transaction file. 
Determine next segment to be processed in enter mode. 
Consists of routines for the following: 


e Handle automatic puts and program-defined processing within 
current segment. 


e« Get specified CDB from work file and place it in the pool. 


Perform session deactivation, sign-off transaction file and work 
session termination, and initiate the EW and EJ processing 
segments. 


Consists of routines for the following: 


e Drive interaction cycles, restore get-suspended session, accept 
user, set command/function key indicators, and select 
appropriate routine for keyed response or request. Save or 
restore normal WDB for cycle turnover. 


e Get normal or alternate WDB from work file into pool element 
and transfer corresponding sections to work station level JDB 
fields, common indicators, and common data pointers. 


e Put work station level JDB fields, common indicators, and 
common data pointers into corresponding sections of normal or 
alternate WDB in pool element. 
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Execution- 


Time Modules Descriptive Name 


#WSX11 
#WSX12 


#WSX13 


#WSX14 


#WSX15 


#WSX16 


#WSX17 
#WSX18 


#WSX19 


#WSX20 


WSU execution transient 11 


WSU execution transient 12 


WSU execution transient 13 


WSU execution transient 14 


WSU execution transient 15 


WSU execution transient 16 


WSU execution transient 17 


WSU execution transient 18 


WSU execution transient 19 


WSU execution transient 20 


Function 


Process WSU calculation specification multiply operation. 


Process WSU calculation specification divide operations and move 
remainder operations. 


Process WSU calculation specification table compare operations 
for table of alphameric literals or table of alphameric fields. 


Process WSU calculation specification table compare operations 
for table of numeric literals or table of numeric fields. 


Convert specified binary value to decimal character equivalent in 
JDB or decimal character value in JDB to binary equivalent in key 
area. 


Route control to appropriate processor for response to WSU 
message or MENU display. Handle abnormal completion code 
from work station data management 4 | 


Get and update trailer information from transaction file record. 
Perform the following: 


e 1/O for calculation specification or review of GETPH, GETPR, 
GETNH, or GETNR operation. 


e |/O for GET calculation specification operation. 
« Format trailer information transaction file adds or inserts. 
e Allocate pool element. 


Handle review mode processing. Zero or blank all normal or 
alternate work station level JDB fields. 


Perform LOKUP operation for WSU array manipulation. 
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Ideographic Sort Utility Directory 


Module Name 


O.#KA$SA 
O.4KA$D 
O.#KASE 


O.#KASX 


O.#KA@HELP 
O.#KA$HELP 


O.#KABA 
(phase OB) 


O.#KABC 


O.4#KACA 
(phase OC) 


O.#KACB 


O.4KACC 


O.#KACE 


O.#KACF 


O.#KACK 


O.#KACL 
O.#KACZ 
O.#KADA 
0.4KADB 
(phase OD) 


O.4KAEA 
(phase OE) 


Function 


Print sort's COMMON area with labels after phases OA, OB, OD, OE, and all passes. 
Contain phase OD COMMON constants. Serve an input to 0.4KA$A when dumping COMMON. 


Determine if there is enough available storage to load 0.4#KA$A (sort COMON dump routine). If 
there is enough available storage, load O.4KA$A. 


Contain phase 1, 2, and 3 COMMON constants. Serve as input to O.4KA$A when dumping 
COMMON. 


Display screen formats for ideographic sort prompts (for nonideographic session). 
Display screen formats for ideographic sort prompts (for ideographic session). 


Finish diagnosing the header statement and issue messages if any errors are detected. Pseudo 
open and allocate the input file. 


Allocate the work file, if work file (FILE) statement present. 

Read the statement following the header statement. 

If ALTSEQ specified, load and call 0.A4KABC. 

Read and diagnose ALTSEQ statements and issue messages if any errors are detected. 


Modify the 256-byte alternate collating sequence table as specified on the ALTSEQ statements 
that are read in. 


Read and diagnose sort sequence specifications for one sort run. 


Issue error messages based on the error table generated in phase OC. Determine if any terminal 
errors were diagnosed by phase OC; if they were, pass control to 0.4KAGA. 


Move the select/build routine to its final position in storage. Move the summary table behind 
select/build routine if summary sort is used. 


Diagnose the sequence specification statements to determine if they are valid include or omit 
statements. Generate code segments from the information on the include/omit statements. 


Diagnose the sequence specification statements to determine if they are valid field statements. 
Generate code segments from the information on the field statements. 


Diagnose include/omit record type specifications with a factor 2 keyword. Generate a valid 
include/omit sequence specification statement. 


Calculate module length. 

Complete select/build code. Move the summary table to phase 1 location behind COMMON. 
Determine the active program lengths of modules 0.4KA1X, 0.#KA2A, 0.#KA3A, and 0.AKA3S. 
Design the execution phases of the sort program (phase 1, phase 2, and phase 3). 

Check for terminal error in design of sort. If found, pass to O.f4KAGA. 


Allocate output file, if not the same file as the input file. If work file (FILE) statement omitted, call 
automatic work file allocation (@KAEG). 
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Module Name 


Function 


O.#KAGA 


(phase OG) 


O.#KASE 


O.4KASRT 
(phase OA) 


O.#KATB 
O.#KATL 
O.#KAZA 
0.#KA1D 


O.#KA1L 


O.4KA1X 
(phase 1) 


O.#KA1Z 


O.#KA2A 
(phase 2) 


O.#KA2L 


O.4KA3A 
(phase 3) 


O.#KA3L 


0.4KA3S 
(phase 3) 


O.4KA4A 
(phase 4) 


0.#KA9G 
O0.#KA9I 


0.#KAIM 
O0.#KA9P 
0.#4KA9S 


Issue messages indicating errors found and information determined in the generation phases. 


Convert 1-byte EBCDIC KANA reading field to Seion KANA control field. 


Do initial sort. 


Determine if #KAMAST and #KACTIVE are on disk. Generate the active collating sequence tables. 
Build ideographic control field. 
Move a given number of bytes from one area in storage to another. 


Calculate and place in COMMON the sector address (SSS) of the current work block. Calculate 
and place in COMMON the SSS of the next work block. 


Perform initialization for O.4KA1X. Load into storage the required phase 1 modules for 0.#KA1X. 


Perform a tournament sort, produce variable-length strings of sequence work records, and place a 
string of a variable number of work record blocks onto the work file. At end of pass for a 
Summary sort, move the summary table from the next byte after the select/build code to the next 
byte after COMMON. 


Issue messages indicating errors found and information determined in the preceding execution 
phase. 


Merge strings created in phase 1 until the total number of strings is less than or equal to the 
sort’s order of merge. 


Load into storage the required phase 2 modules for 0.f#KA2A. 


Allocate the output file, if it is the same file as the input file, perform last pass of the merge, and 
place the sorted records consecutively in the output file. 


Perform initialization for the phase 3 modules (0.4#KA3A/0.KA3S), and load into storage the 
modules required by 0.4KA3A/0.KA3S to perform phase 3. If the number of remaining strings is 
less than the order of merge, redesign the sort for phase 3. 


Allocate the output file, if it is the same file as the input file, and perform last pass of the merge. 
If no summary table exists, delete duplicate records; if a summary table exists, summarize 
duplicate records as specified, and place the sorted records consecutively in the output file. 


Issue displayed message and end the job after unsuccessful completion via the SYSLOG transient 
routine. Terminate the sort program after successful completion. 


Provide the logical get |/O function for the work file. 


Read sort sequence specification statements, which are in a procedure member or are entered 
from the display station keyboard. 


Read sort sequence specification statements from the loadable sort parameter list. 
Provide the logical put |/O function for the work file. 


Read sort sequence specification statements from a source member. 
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Module Name Function 


@KADC Compute the initial area in phase 1 to be assigned to the internal sort area. 

@KAEG Determine the space needed for the work file and use special allocate to automatically allocate it. 

@KAZB Convert an unsigned zoned decimal number (up to 7 bytes long) to a 3-byte hex number. 

@KAZC Convert a 3-byte hex number to a 7-byte zoned decimal number and concatenate a sign byte to 
the result. 

@KAZD Divide a 3-byte hex number into another 3-byte hex number. 

@KAZE Convert 4-byte groups into their equivalent 9-bit EBCDIC values. 

@KAZF Convert 1 byte of storage to printable EBCDIC values, 1 bit at a time. 

@KAZM Multiple two 3-byte hex numbers. 


The following module is the loadable sort transient that is packaged as part of the SSP. 


0.4MAGS Load and give control to #KASRT. Set the completion indicator and return control to the program 
that called sort. 
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Ildeographic Character Generator Utility 


Module Name Descriptive Name Function 


#CGIN CGU initialization Open extended ideographic character file (FEXTN) and master 
sort information file (FKAMAST), and allocate the active 
collating sequence file (#KACTIVE). 


Allocate and open the display station. 
Locate all CGU modules and build a parameter table. 


Load #CGCM (common data areas) and #CGSB (common 
subroutines) into lower portion of #CGIN. 


Retrieve keywords from #CG#MG and save them in common 
area. 


Initialize data areas in common area. 


#CGCM CGU common data areas Contain the initialized common data structure (CGCOM) used 
by all modules. 


Contain all file DTFs, physical buffers, |OBs, display station 
DTFs, printer DTFs, physical print buffers, and format index 
|/O areas. 


#CGSB CGU common subroutines Load requested module, if required, and specify which modules 
are already loaded. 


Issue SYSLOG messages. 

Perform display station |/O. 

Analyze function and command keys (called by WSRTN). 
Right-adjust a numeric field. 

Convert extended character numbers to the RRN in #EXTN file. 
Convert RRN to sector address in #EXTN file. 

Convert sector address to RRN in #EXTN file. 

Convert RRN to extended character number. 

Convert IBM code to RRN in #KAMAST. 

Retrieve a record from #EXTN file. 

Retrieve a record from #KAMAST file. 


#CGML CGU mode control Determine what function is requested via command key (entry, 
update, sort, delete, list, end of job). 


Load and pass control to the appropriate execution module 
when function is determined. 
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Module Name Descriptive Name Function 


#CGEN CGU entry mode Determine next available location for new character in the 
#EXTN file. 


Prompt the operator for the number of the next character to be 
created. 


Check that the #EXTN character is not already defined. 
Call #CGEU to process the description of the new character. 


Call #CGAL to process the sort information, and write the new 
character and sort information to the respective files. 


#CGUP CGU update mode Prompt the operator for the number of the character to be 
updated. 


Check that the requested character is a user-defined character. 
Check that the #EXTN character is defined. 


#CGSO CGU sort mode Prompt the operator for the character numb-¢<r of the sort 
master record to be updated. 


Display and allow the operator to change the sort information 
in the sort master file; for [MB-supplied characters only, allow 
update to single pronunciation. 


Call #CGAL to write the updated sort information in the master 
sort file and to print the updated sort information if the print 
status is on. 


#CGDE CGU delete mode Prompt the operator for the number of the #EXTN character to 
be deleted and display the character before deleting it. 


Call #CGAL to delete the character from the #EXTN file and 
the master sort file. 


Call #CGAL to print deleted records. 
#CGEJ CGU end of job Prompt the operator for ending or continuing the job. 
Display number of records processed. 


If YES response to end-of-job prompt, print number of 
records processed if any printing has occurred. 


If NO response to end-of-job prompt, return to the exited 
mode. 


#CGLI CGU list mode Prompt the operator for the upper and lower limits of the 
characters to be printed. 


Check that the character print limits correspond to the 
characters in the |BM-supplied extended ideographic character 
set (excluding special symbols), or to the characters in the user 
defined set. 


Check that the upper limit is greater than or equal to the lower 
limit. 


Print the characters and master sort information within the 
limits specified. 
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Module Name 


#CGEU 


#CGAL 


Descriptive Name 


CGU character definition 


CGU common subroutines 


Function 


Prompt the operator for a description of new and updated 
characters. 


Process the description of new and updated characters. 
(#CGEU displays the character as it is being defined or 
changed, and allows the user to restart character definition.) 


Process the Copy command function key to allow the user to 
copy and optionally combine characters during character 
definition. 


Call #CGAL to write new and updated character definition in 
the #EXTN file. 


Flag #KACTIVE file when active collating sequence changes. 
Write record to #EXTN file. 
Write record to #KAMAST file. 


Move record from the |/O buffer to the image buffer for 
processing. 


Prompt for sort information. 

Initialize sort hold fields. 

Convert information from #KAMAST to displayable format. 
Process user response to sort information prompt. 
Process Enter key response to sort information prompt. 
Check for blank fields with special symbol character type. 
Convert image to matrix form. 

Perform printing. 

Allocate and open printer. 

Print title and column heading lines. 

Print second line of matrix and updated sort information. 
Print remaining matrix lines. 

Interface with printer data management. 

Convert binary value to decimal. 

Convert decimal value to binary. 


Convert hex value to EBCDIC. 
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Query/36 Directory 


Module Name 


Descriptive Name 


#ODDE 
#ODDI 
#QDDU 
#ODEI 
#ODEU 
#ODEX 
#ODFB 
#ODGN 
#ODLN 
#ODMP 
#QDSS 
#OQDUD 
#OQDWS 
#QUDA 
#QUDB 
#QUDC 
#QUDD 
#QUDE 
#OQUDF 
#QUDG 
#QUDH 
#OUDI 
#OQUDJ 
#QUDK 
#OQUDL 
#QUDM 
#QUDN 
#QUDO 
#QUDP 
#QUDQ 
#QUDR 
#QUDS 


Entry and insert modes mainline (for sequential or direct files) 
File specifications diagnosis processor 

Update mode mainline (for sequential or direct files) 

Entry and insert modes mainline (for indexed files) 

Mainline subroutines 

Initialization for execution processor 

Data entry control statement generator 

File, data definition, and data entry specifications generator 
Data dictionary link processor 

Data entry attribute specifications generator 

Data entry source specification save processor 

Update mode mainline (indexed files) 

Work station source specification generator 

Query /36 initialization 

Work with queries display 

Define the query display 

File/format selection 

Join files display and diagnostics 

Record selection display 

Field selection 

Sort field selection 

Select collating sequence and user defined collating sequence 
Column formatting and summarization display 

Result field definition display 

Break fields display 

Select output device and output type display 

Show file selections and join tests display 

Copy queries display 

Library list display 

Review/view query, reads query from library into task work space 
Delete queries display 


End this query display 
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Module Name 


#OUDT 
#OUDX 
#OQUDY 
#QUDZ 
#QUD2 
#OUF2 

#OUK2 
#QUK3 
#OQUPD 
#OUPF 

#QURA 
#QURB 
#QURC 
#QURD 
#OQURE 
#OQURF 

#QURG 
#QURH 
#QURI 

#QURJ 

#OURK 
#OUTA 
#QUTB 
#OUTC 
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Descriptive Name 


File/format definition extract and field table build 
Show long comments for files, format, and fields 
Translated language collating sequence tables 
Query subroutine build (compile query subroutine) 
File list build 

Record selection diagnostics 

Result field definition diagnostics 

Save/restore for result field definition 

Print query definition 

Print format of query output to disk file 

Query run initialization 

Run query to display or show report layout 
Return data to DW/36 print for multicopy 

Run query to printer 

Determine report format 

Compile code to format detail lines 


Initialize for run-time record selection 


Compile code to format summary lines and process breaks 


Run query to disk when summary output only requested 


Call query data management to open the query 
Run query to display format data routine 


Return data field instructions to DW/36 editor 


Document output driver and return data to DW/36 print for column list 


Return data to DW/36 editor 
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PS/36 Directory 


Module Name 


#ODBA 
#ODBC 
#ODBD 
#ODBE 
#ODBG 
#ODBH 
#ODBK 
#ODBM 
#ODBN 
#ODBO 
#ODBP 
#ODBQO 
#ODBR 
#ODBS 
#ODBZ 
#ODFF 
#ODFI 
#ODFS 
#0DL1 
#ODL2 
#0DL3 
#ODL5 
#ODL6 
#ODL7 
#ODL8 
#0ODL9 
#ODPH 
#ODPL 
#ODQOA 
#ODQE 
#ODQJ 


Function 


DiA—Update status log. 


DIA—Time-stamp the queue for connection failure. 


DlA—Document-unit decoder. 
DIA—Negotiate sign-on to partner. 
DiA—Get reply from session printer. 
DlA—Search command encoder. 
DlA—Parser. 

DlIA—Get inbound data area. 
DIA—Send command to session partner. 
DIA-—SRL decoder. 

DIA—File server, terminate write. 
DIA—File server, write. 

DIA—Get command from queue. 
DlA—Search transaction processor. 
DIA session manager. 

File document to DISOSS. 

DLS temporary document cleanup. 
Select document for file to DISOSS. 
Maintain access codes. 

Maintain keywords. 

Maintain document classes. 

View list of access codes. 

View list of keywords. 

View list of document classes. 
View list of access codes. 

View list of document classes. 
Copy search results to another user. 
View list of PS/36 users. 

DLS request handler. 

Send manager. 


NEP cancel. 
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Module Name 


#ODQS 
#ODQT 
#ODQY 
#ODQZ 
#ODRL 
#ODSC 
#ODSD 
#ODSL 
#0DSO 
#ODSR 
#ODSW 
#OUAA 
#OUAC 
#OUAD 
#OUAE 
#OUAG 
#OUAL 
#OUAM 
#OUAP 
#OUAQ 
#OUAR 
#OUAS 
#OUAT 


#OUAW 


#OUAX 
#OUAY 
#OUAZ 
#OUA 1 
#OUA2 
#OUA3 
#OUA4 
#OUBB 
#OUBE 


C-22 


Function 


View library request status. 
DLS time-stamp. 
DLS copy task. 


DLS copy task status update. 


Select from list of remote libraries. 


Copy, change, create a search. 
Delete searches. 

Document function router. 
Choose print options. 

Work with documents found. 
Work with searches. 

Analyze mail folders. 

Control communications queues. 
Install OSU files and libraries. 
Display queue entries. 

Get number of logical records. 
Maintain remote destinations. 
Maintain mail folder. 


Process remote destinations. 


Maintain communication queue definitions. 


Maintain communications routes. 


Generate save/reorganize OCL. 


Start transmission on communication queues. 


Delete documents confirmation screen. 


Delete routes confirmation screen. 


Delete queue confirmation. 


Delete queue entry confirmation. 


Install GFFICE/36 files on mail library. 


Install non-OFFICE/36 files. 


Install OFFICE/36 files on mail library. 


Profile file conversion. 


Build the asynchronous feedback records. 


Log a router destination error. 
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Module Name 


#OUBF 

#OUBJ 

#OUBK 
#OUBR 
#OUBS 
#OUBX 
#OUCA 
#OUCB 
#OUCC 
#OUCD 
#OUCE 
#OUCF 
#OUCG 
#OUCI 

#OUCJ 

#OUCK 
#OUCL 
#OUCM 
#OUCN 
#OUCO 
#OUCP 
#OUCQ 
#OUCR 
#OUCS 
#OUCT 
#OUCU 
#OUCV 


#OUCW 


#OUCX 
#OUCY 
#OUCZ 
#OUC 1 
#OUC2 


Function 


Route for FINDSLOT. 

Cancel PS/36 NEPs. 

Confirm PS/36 NEPs stopped. 

Route and direct services. 

Perform routing service. 

Flush newest slot in fanout list. 

Perform calendar processing. 
Update/delete/add calendar items. 

Print and/or delete calendar entries. 
MODULE TO USE OUCLCF. 

Overlay module to call common abort program. 
Overlay module for OUCLF. 

Set up week-, day-at-a-glance views. 
Calendar select. 

Call #OUCL to select one calendar. 

Define calendar session test version. 
Prompt user for calendar selection. 
Perform simple call to OUCLOP. 

OUCLX overlay version. 

Dummy driver for OUCLOP. 

Overlay interface to OUFCMN. 

Build combined view of invitee list calendars. 
Determine range for print/delete. 
Calendar session. 

Print or delete calendar entries. 

Create, change, or delete calendars, managers, or descriptions. 
Build list view for normal processing. 
OVERLAY FOR OUCLVU. 

Build list view for EXP VERF AND CONF. 
Prepare for batch print delete of calendar. 
Batch print/delete of calendar items. 
Add/change group meetings. 


Delete group meetings/update meeting items. 
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Module Name Function 


#OUC3 View /update the invitee list of a group meeting. 
#OUC4 Schedule/delete group meeting on 2-30 calendars. 
#OUC5 Update meeting item on an invitee calendar. 
#OUC6 Six-month calendar view. 
#OUC7 Build combined view of invitee list calendars. 
#OUDA DIA session state controller. 
#OUDB Get command work area (CWA). 
#OUDC Put reply work area (RWA). 
#OUDD Process data distributions of DIA catcher. 
#OUDF Process request-distribution command. 
#OUDG Process SRR-cancel-distribution command. 
#OUDH Process SRR-set-control-value command. 
#OUDI DIA catcher—print for indirect users. 
#OUDJ Process SRR-sign-on-request command. 
#OUDK Process list command. 
#OUDL Process NRR-ACK-4 command. 
#OUDM Process obtain command. 
#OUDN Get next distribution. 
#OUDO Obtain documents for a general user. 
#OUDP Process acknowledge-3 command. 
#OUDO Status correlation. 
#OUDR DIA catcher program. 
#OUDS Distribute a document and/or message for a general user. 
#OUDT Handle DIA catcher-—status distribution. 
#OUDW Provide transfer overlay to do correlation. 
#OUDX Build page heading from list document. 
#OUDY Distribute data distribution to group. 
#OUFE Disk I/O abort. 
#OUGD Process group delete confirmation screen. 
#OUGL Control display of screen OUGRO6. 
#OUGP Process present print options screen. 
#OUGQO Present print option screen for multiple selections. 
#OUGR Resolve group. 
#OUGU Update/create a group. 
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Module Name 


#OUGV 
#OUGW 
#OUGX 
#OUHC 
#OUHL 
#OUHM 
#OUHR 
#OUHS 
#OUHT 
#OUHU 
#OUJD 
#OUJK 
#OUJS 
#OUJU 
#OUKD 
#OUKS 
#OUK 1 
#OUK2 
#OUK3 
#OUK4 
#OUK5 
#OUKE6 
#OUMA 
#OUMB 
#OUMC 
#OUMD 
#OUME 
#OUMF 
#OUMG 
#OUMH 
#OUMI 
#OUMJ 
#OUMK 


Function 


View merged or unmerged group. 

Control display of screen OUGRO2. 

Enrollment and authority check. 

Log error message from DIU parser. 

Log messages to system console and history file. 
SNADS send messages to console/history file. 
SNADS receive manager. 

Decoder. 

SNADS receive manager. 

SNADS receive manager. 

SNADS distribute data/status common. 
SNADS distribute data/status common. 
SNADS distribute status. 

SNADS distribute data/status common. 
Decoder. 

Decoder. 

Write DOD, SPST, or DEST structure to queue. 
Read SNADS directory table. 

Read SPST, DOD, and destination structure. 
SNADS addressing token translate. 

SNADS addressing token translate. 

SNADS parser, get next route. 

Send/forward messages. 

Print a document from mail. 

Process create/delete mail log screen. 

Process send/forward mail screen. 

Interface between DW/36 and #OUMD. 

File a document out of the mail library. 
Allocate/deallocate SNADS file at beginning/end of send mail. 
Log hard-copy mail. 

Sort/eliminate duplicate recipients. 

Message type substitution. 


Print mail log listing. 
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Module Name 


Function 


#OUML Process review-mail-log screen. 
#OUMM Process send-a-message screen. 
#OUMO Specify print options. 

#OUMP Define a sublist of the mail log. 
#OUMQ Access (Q-file. 

#OUMR Print the mail audit report. 

#OUMS Process mail status screen. 

#OUMU Delete files or documents. 

#OUMW View/change mail log entry. 

#OUMX View a memo slip. 

#OUMY Check the personal document PSWD. 
#OUM 1 Send/forward/reply note screen. 
#OUM2 Other mailing information for a note. 
#OUM3 Recover a note. 

#OUM4 Build include instruction for forwarded note. 
#OUPC Create calendar and mail log during enrollment. 
#OUPD Enroll Displaywriter users. 

#OUPF Install office default. 

#OUPG Driver for updating of general user profile. 
#OUPO Delete enrollment. 

#OUPR Enroll PS/36 users. 

#OUPS Enroll self. 

#OUPU View general user information. 
#OUPW View Displaywriter user information. 
#OUQP Process start/stop-activity queue. 
#OUQS Process activity queue. 

#OURG View names within a group. 

#OURI List directory by user ID and name. 
#OURL Select directory entries. 

#OURM Select receivers for mail. 

#OURN Alphabetically list names. 

#OURP View update for #OURG. 

#OURR Process list for #OURG. 
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Module Name 


#OURS 
#OURT 
#OURU 
#OURZ 
#OUSA 
#OUSB 
#OUSC 
#OUSD 
#OUSE 
#OUSF 

#OUSG 
#OUSH 
#OUSM 
#OUSN 
#OUSP 
#OUSU 
#OUSV 
#OUSW 
#OUSY 
#OUSZ 
#OUS 1 

#OUS2 
#OUS3 
#OUS4 
#OUS5 
#OUS6 
#OUS7 
#OUXA 
#OUXH 
#OUXI 

#OUXL 
#OUXO 
#OUXR 


Function 


Select receivers for messages. 


List telephone directory. 


Process update, delete, view for RI, RT, and RN. 


Get system values, authority, enrollment. 
Server-initiate read. 

Server-—read. 

Server—lock and release data object. 
Server—terminate read. 
Server-initiate write. 

Server—write. 

Server—terminate write. 

Scottish bid main line. 
Server—terminate write profile. 
Server—backout write. 

SNADS send-start session. 

SNADS send-no more DliUs. 
SNADS send. 

SNADS send-control connection. 
SNADS send—purge queue. 

SNADS send-suffix T2. 

SNADS send—RCV NACK. 

SNADS send—end of NACK. 

SNADS send—decode NACK. 
SNADS send—abort NACK. 

SNADS send-—feedback. 

SNADS send-data object. 
Server—decode DIA document unit. 
Build queue definition in SQS. 
Dequeue the task block for the present task. 
Asynchronous lock task. 

SNADS address token validation. 
Build queue definition in SQS. 
PS/36 IPL procedure for scheduler. 
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Module Name Function 


#OUXT Clean up control block chain. 

#UMCA Process migrate calendar A. 

#UMCB Process migrate calendar B. 

#UMDL Process migrate distribution list. 
#UMPR Process migrate profile. 

#UMRA Produce migrate profile report. 

#UMRB Produce migrate calendar report. 
#UMRC Produce migrate distribution list report. 
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DW/36 Directory 


Module Name Function 

#PFAB Perform final processing subroutines. 

#PFAD Create/delete #TEXTWRK. 

#PFAI Format index pages. 

#PFAL Allocate DTFs for printers/files. 

#PFAT Copy page/line formats. 

#PFCP Create cover page. 

#PFDL Deallocate DTFs for printers/files. 

#PFED Perform editing for data merge/summary math. 
#PFER Open resolved document. 

#PFEX Display the EXIT A DOCUMENT display. 

#PFFP Perform final processing/line numbers/change flag. 
#PFHF Create the headers and footers. 

#PFHH Create the outline headings/help tag tables. 
#PFIB Create the build table for auto-index. 

#PFIC Perform the interactive L/A copy function. 
#PFIF Perform format changes in an include. 

#PFIG Perform interactive German hyphenation. 

#PFIl Perform interactive L/A instruction parser. 
#PFIL Perform interactive line adjustment during edit. 
#PFIN Perform include processing. 

#PFIP Perform interactive L/A attribute propagate. 
#PFIX Perform include transformations. 

#PFLA Perform output line adjust. 

#PFLO Display first two of the three LABEL PRINT OPTIONS displays. 
#PFLP Merge labels into a composite document. 
#PFL3 Display third of the three LABEL PRINT OPTIONS displays. 
#PFMD Perform merge from a document. 

#PFMG Perform the merge function. 

#PFMO Display merge options. 

#PFMP Perform the merge initialization function. 
#PFNT Perform PS/36 note processing. 

#PFOC Perform the output L/A copy function. 
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Module Name Function 


#PFOE Perform output L/A error logging. 
#PFOG Perform output L/A German hyphenation. 
#PFOH Perform resolution of outline heading and outline heading text instructions. 
#PFOP Perform output L/A attribute propagation. 
#PFPD Display the 6580 DISPLAYWRITER OPTIONS display. 
#PFPG Display the SAVE OPTIONS display. 
#PFPH TEXTREL procedure handler. 
#PFPI Display the 6670 PRINT OPTIONS display. 
#PFPL Perform pagination and line adjustment of printed document and control the flow of print 
resolution/pagination/line adjustment. 
#PFPM Perform print function mainline routing. 
#PFPO Display first two of the three PRINT OPTIONS displays. 
#PFPP Perform output pagination. 
#PFPQ Interface to query to resolve data base markup during print. 
#PFPR Resolve markup that is already resolved to text. 
#PFPS Perform print resolution subroutines. 
#PFPW Perform widow line processing for output. 
#PFPX Perform #PFPM extra subroutines. 
#PFP3 Display the third of the three PRINT OPTIONS displays. 
#PFOM Spool/JOBQ manager. 
#PFRE Remove spelling errors from document. 
#PFRO Display the two PRINT OPTIONS displays for printing resolved documents. 
#PFSL Perform pagination and line adjustment of a source document. 
#PFSM Resolve summary math instructions. 
#PFSP Perform source pagination. 
#PFTB Resolve tabs for data/text and math. 
#PFTC Build the table of contents page. 
#PFTU Perform parse instructions. 
#PFXE Log errors to the error page. 
#PFXF Interface to print transformations and evoke procedures. 
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Module Name 


#TUAA 
#TUAD 
#TUAV 
#TUBK 
#TUBO 
#TUBR 
#TUBX 
#TUCE 
#TUCF 
#TUCK 
#TUCL 
#TUCN 
#TUCO 
#TUCP 
#TUCR 
#TUCV 
#TUDA 
#TUDD 
#TUDE 
#TUDF 
#TUDI 
#TUDL 
#TUDN 
#TUDO 
#TUDP 
#TUDR 
#TUDT 
#TUDV 
#TUDW 
#TUDX 
#TUDY 


Function 


Add to addenda dictionary. 
Create/delete work library. 

Process average instruction. 

Process begin keep. 

Process begin overstrike. 

Process spell box input. 

Build box on AID request. 

Perform character field editing. 
Process change format. 

Process command keys for #TUEC. 
Process column copy, move, or delete. 
Process comment. 

Process color instruction. 

Clear pending commands. 

Process CR/RCR aids. 

Process count statement. 

Process date statement. 

Create or revise document description. 
Execute document requests. 

Process data file options. 

Process document ID statement. 
Perform document selection. 

Rename document. 

Process document options. 

Print document list. 

Delete document. 

Process data field instructions menus. 
Process document variable. 

Edit document list. 

Execute document requests-extended. 


Copy document. 
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Module Name 


Function 


#TUEA Process for spelling aid. 
#TUEB Build edit text lines. 
#TUEC Execute command requests. 
#TUED Edit display. 
#TUEF Find options. 
#TUEG Get options. 
#TUEK Build command key template. 
#TUEL Build format scale lines. 
#TUEM Format change lines. 
#TUEP Process pending line functions. 
#TUET Set up for text delete with WSC. 
#TUEV Perform spelling verification. 
#TUEX Execute command keys. 
#TUEY Process synonyms. 
#TUFH Process data field heading. 
#TUFM Move, copy, or delete format. 
#TUFR Find or replace. 
#TUFW Find word. 
#TUGA Perform Germanic spelling aid. 
#TUGF Change font. 
#TUGG Get graphic file. 
#TUGH Perform Germanic hyphenation. 
#TUGL Perform grade level analysis. 
#TUGO Go to another list module. 
#TUGR Process graphic instruction. 
#TUGV Perform Germanic verification. 
#TUGZ Perform Germanic hyphenation. 
#TUHC Outline heading definition. 
#TUHF Process header or footer. 
#T UHI Process instructions for header or footer. 
#TUHP Process help tutorial. 
#TUHT Process outline heading text. 
#TUHV Process high instruction. 
#TUHX Process outline heading. 
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Module Name 


#TUHY 
#TUIE 
#TUIF 
#TUIH 
#TUIK 
#TUIN 
#TUIPL 
#TUIS 
#TUIT 
#TUIX 
#TULC 
#TULD 
#TULF 
#TULL 
#TULN 
#TULV 
#TUMF 
#TUMK 
#TUMN 
#TUMT 
#TUNE 
#TUNF 
#TUNL 
#TUNM 
#TUNS 
#TUOE 
#TUOL 
#TUOW 
#TUPA 
#TUPC 
#TUPE 
#TUPF 
#TUPG 


Function 


Perform hyphenation. 

Process index entry instruction. 
Process begin conditional text. 
Process CMD11 to insert hyphens. 
Process instruction key interface. 
Process include statement. 
Perform DW/36 time initialization. 
Perform spelling workspace initialization. 
Build translate tables. 

Process index instruction. 
Process locate statement. 
Process text library description. 
Process line format options. 
Perform text library select. 
Process line commands. 

Process low instruction. 

Perform master format selection. 
Perform spelling verification. 
Perform text library maintenance. 
Process for margins and tabs. 
Perform numeric field editing. 
Change format. 

Process numbered list. 

Process text month names. 


Select subset list. 


Perform object execution and maintenance. 


Perform object selection. 

Select object list. 

Process page statement. 
Process position line commands. 
Process page end statement. 
Perform page format definition. 


Perform pagination. 
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Module Name 


#TUPH 
#TUPK 
#TUPN 
#TUPO 
#TURA 
#TURB 
#TURE 
#TURH 
#TURP 
#TURT 
#TURV 
#TUSA 
#TUSK 
#TUSM 
#TUSN 
#TUSO 
#TUSP 
#TUSR 
#TUSV 
#TUTA 
#TUTB 
#TUTC 
#TUTD 
#TUTE 
#TUTF 
#TUTG 
#TUTI 

#TUTN 
#TUTO 
#TUTS 
#TUTV 
#TUTX 
#TUT1 


Function 


Process procedure. 
Process print key options. 


Process page number statement. 


Display the WORK WITH DOCUMENTS display. 


Revise supplemental dictionary. 
Process required backspace statement. 
Reset errors. 

Process running head statement. 
Perform replace for find/replace. 
Perform root phase processing. 
Perform recovery. 

Process for special aids. 

Process skip command. 

Process summary math instructions. 
Process system page number command. 
Process spelling options. 

Display the SPELLING OPTIONS display. 
Perform DW/36 common subroutines. 
Check words. 

Process for text aids. 

Process table of contents. 

Process table of contents menu. 
Process text delete. 

Process time command. 

Process copy of a format. 

Process help text label. 

Process text body instructions. 

Process text delete. 

Process text operation complete. 
Process for text shift. 

Process total instruction. 

Move, copy, or delete text. 


Process text copy. 
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Module Name 


#TUUA 
#TUUE 
#TUUL 
#TUUM 
#TUUP 
#TUUR 
#TTUS 
#TUVN 
#TUVW 
#TUWD 
#TUWI 
#TUWL 
#TUZI 


This document contains restricted materials of IBM. LY21-O590-4 


Function 


Update supplemental dictionary. 
Update page end. 

Update lines. 

Process prompt line. 

Update edit display. 

Update for remote work station. 
Perform interactive spell check. 


Process data field instruction. 


Process view document command. 


Process work station description. 
Process work station initial. 
Process wide lines. 


Process zero index command. 
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Development Support Utility Directory 


Module Name 


#EDED 
#EDEJ 
#EDFC 
#EDFD 
#EDIN 
#EDIS 
#EDIT 
#EDL1 
#EDL2 
#EDML 
#EDRA 
#EDRC 
#EDRC 
#EDRD 
#EDRE 
#EDRF 
#EDRI 
#EDRO 
#EDRT 


#EDVW 


C-36 


Function 


Perform edit functions. 

Perform exit functions. 

Perform find/change operations. 
Perform find operation. 

Perform include operation. 

Perform session initialization. 

Perform edit initialization. 

Check all line commands entered for errors. 
Execute all line commands. 

Member list processor. 

Syntax checker for RPG II specifications. 
Syntax checker for RPG II specifications. 
Syntax checker for RPG Il specifications. 
Syntax checker for RPG II specifications. 
Syntax checker for RPG II specifications. 
Syntax checker for RPG Il specifications. 
Syntax checker for RPG Il specifications. 
Syntax checker for RPG Il specifications. 
Syntax checker for RPG II specifications. 


Perform all view processing except find operations. 


This document contains restricted materials of IBM. LY21-0590-4 
©Copyright IBM Corp. 1983, 1984, 1985, 1986 


A 


abbreviations and acronyms xi 
office product device to BSCEL 
protocols A-15 
access method, library 2-186 
active format-1 area access 2-190 
add disk file to diskette file 2-268 
add request processing, disk data 
management 2-90 
additional module information 4-1 
administration (see DW//36 interfaces, SSP to) 
advanced program-to-program Communications 
subsystem (see APPC) 
advanced peer-to-peer networking 
subsystem (see APPN) 
alert support (see communications and 
systems management) 
allocate 2-67 
data communications 2-74 
normal 2-67 
special 2-70 
allocate/terminate, service logging 2-243 
APAR utility 2-230 
APPC subsystem 2-556 
line protocols A-66 
APPN subsystem 2-560 
line protocols A-75 
assembler language modules (refer to 
Appendix B) 
assembler language interfaces, SSP to 3-20 
attach, supervisor task 2-205 
attributes, program 3-5 
auto response utility 2-251 
autocall phone list utility, define 2-320 
autocall support 2-447 


basic exchange and I-exchange utility 2-252 
BASIC modules (refer to Appendix B) 
BASIC interfaces, SSP to 3-12 
BSC 
batch 2-419 
BSC interrupt handler, SSP-ICF (see 
SSP-ICF BSC link control) 
CCP subsystem 2-543 
monitor utility, start 2-317 
monitor utility, stop 2-316 
protocols A-1 
BSCEL subsystem 2-546 
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Index 


build 
membership table 2-194 
menu utility 2-256 
rename utility 2-366 
utility, file 2-280 
utility, message 2-314 


C 


C & SM (see communications and systems 

management) 

C/SNA, SSP-ICF 2-518 
activate/deactivate 2-524 
introduction 2-519 
mainline 2-520 
transmit/receive normal 2-522 

CCP subsystem 2-543 

change management 2-600 

change origin point 2-206 

change, library member 2-184 

changes to this manual x 

character generator utility interface, 

SSP to 3-9 

chart numbering description 2-5 

chart references, directory 4-1 

checker, syntax 2-207 

CICS subsystem 2-539 

cleanup processing, SDDM 2-146 

cleanup, command processor 2-57 

close 2-163 

CNOS (see APPC) 

COBOL compiler modules and execution-time 

subroutines (refer to Appendix B) 

COBOL interfaces, SSP to 3-18 

command processing 2-34 
chart conventions 2-35 
cleanup 2-57 
console display 2-55 
control command processing 2-38 
display station error recovery 2-60 
high-level aids and task-to-task 

communications 2-44 

|/O error recovery 2-58 
initiator command interface 2-61 
inquiry menu option processor 2-48 
job initiation 2-42 
mainline 2-35 
miscellaneous input 2-50 
procedure command processing 2-42 
sign-on 2-37 
special keys 2-52 
system file initialization file 2-62 


Index X-1 


command processing (continued) 
system request/enter and power-on 
aid 2-56 
work station data management, interface 
to 2-54 
work station release 2-46 
communications and systems management 
(C & SM) 2-600 
alert utility 2-604 
change management 2-600 
problem management 2-602 
remote management 2-606 
communications area, system 3-3 
communications configuration utility 2-369 
communications test subfunction 2-246 
compiler modules (refer to Appendix B) 
configuration 
CNFIGSSP print 2-21 
create, edit, or delete 2-20 
drop support 2-24 
load support 2-25 
SSP-ICF 2-26 
BSC/SNA asynchronous line 2-30 
BSC subsystem 2-31 
SNA subsystem 2-32 
work station 2-22 
work station definition 2-23 
configuration utility, work station 2-368 
console display 2-55 
control 
command processing 2-38 
flow (see system function/control flow) 
storage interfaces, SSP to 3-2 
transfer 3-5 
control, SSP-ICF 2-511 
control, program 3-5 
conventions, chart 2-4 
conversion S/34 to S/36 security files (see 
security support) 
copy utility, diskette 2-278 
cross-reference resolver 2-192 


D 


data collection, SMF 2-238 
data communications 2-418 
autocall support 2-447 
batch BSC 2-419 
display station pass-through 
support 2-488 
LAN, support for 2-492 
abnormal termination 2-502 
controller check 2-500 
initialization/termination task 2-495 
link station test 2-472 
multiline communications attachment/ 
eight line communications attachment 
support 2-439 
protocols A-1 


X-2 


data communications (continued) 
remote work station support 2-448 
exception processing 2-470 
get data/save screen 
3270 display stations 2-458 
5250 display stations 2-457 
printer put 2-464 
put data/restore screen 
3270 display stations 2-462 
5250 display stations 2-461 
vary off 2-467 
vary on 2-450 
synchronous data link 2-426 
mainline SDLC subtask 2-432 
SDLC abnormal termination 2-438 
SDLC initialization and termination 
subtask 2-428 
SNA-to-DLC interface 2-435 
X.21 
autocall 2-441 
DEFINX21 SHM line configuration 
utility 2-445 
DEFINX21 utility 2-444 
REQUESTX utility 2-442 
support 2-440 
X.25 support 2-474 
data definition (see interactive data 
definition utility) 
data descriptor area 2-126 
data file utility program product 
interfaces, SSP to 3-21 
data management processing 2-80 
disk 2-82 
diskette 2-92 
distributed (DDM) 2-132 
OFFICE/36 support 2-120 
overview control flow chart 2-81 
printer 2-94 
query 2-160 
SSP-ICF 2-507 
tape 2-116 
work station 2-98 
1255 MCR 2-119 
DDM (see distributed data management) 
deallocate 2-72 
debug (see SSP-ICF user aids) 
define autocall phone list utility 2-320 
define ID utility, SSP-ICF 2-285 
definition, data (see interactive data 
definition utility) 
delete request processing, disk data 
management 2-89 
delete utility, file/library/folder 2-276 
delete, library member 2-182 
dequeue, SDDM 2-136 
description, control flow charts 2-3 
descriptions, subfunction 2-1 
descriptor area, data 2-126 
detach/change origin point, task 2-206 
DFA (see dump file analysis) 
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DFU module directory C-2 
DFU program product interfaces, SSP to 3-21 
diagnostics aids 2-216 
APAR utility 2-230 
communications test 2-246 
diskette utility 2-234 
dump file analysis 2-233 
dump utilities 2-222 
error recording analysis procedure 2-220 
mainline and router 2-216 
online problem determination 2-248 
patch 2-228 
PTF apply/copy 2-237 
service logging 2-242 
setdump 2-232 
system measurement facility 2-238 
tape volume statistics utility 2-236 
test request 2-244 
trace utility 2-229 
diagnostic diskette copy utility (see 
interactive data definition utility) 
directory 
program product utilities C-1 
programming languages_ B-1 
SSP 4-1 
directory chart references 4-1 
directory utilities, network resources 2-384 
disable, SSP-ICF 2-516 
disk copy/display utility 2-258 
add disk file to diskette file 2-268 
high-speed disk file to disk file 
copy 2-269 
high-speed disk file to diskette/tape 
file copy 2-272 
high-speed diskette/tape file to disk 
file copy 2-270 
record mode/remote file copy 2-260 
disk data management 2-82 
disk reorganization utility 2-318 
disk VTOC access 2-195 
diskette 
copy utility 2-278 
data management 2-92 
data save/restore 2-210 
diagnostic utility 2-234 
labeling and initialization utility 2-286 
magazine drive search 2-214 
VTOC read/write 2-196 
display spool file entries utility 2-372 
display station error recovery 2-60 
display station pass-through 
support 2-488 
display utility, VTOC 2-287 
distributed data management (DDM) 
overview 2-132 
source DDM (SDDM) 2-134 
BLDINDEX 2-143 
cleanup processing 2-146 
delete 2-144 
file transfer 2-145 
rename 2-142 


distributed data management (continued) 
source DDM (continued) 

RENQ/RDEQ 2-136 

runtime interface 2-140 

VTOC extract 2-134 

target DDM (TDDM) 2-148 
Release 3 and Release 4 
mainline 2-148 
Release 3 and Release 4 VTOC 
extract 2-157 

Release 5 mainline 2-153 
distributed host command facility (DHCF) 
distributed systems node executive (see 

communications and systems management) 
documentation overview 1-2 
DSNX (see communications and systems 
management) 

dump file analysis 2-233 
dump utilities 2-222 
dump, snap 2-209 
DW/36 module directory C-29 
DW/36 interfaces, SSP to 3-26 


E 


eight line communications attachment (see 
multiline communications attachment) 

enable, SSP-ICF 2-514 

enqueue, SDDM 2-136 

enrollment (see DW/36 interfaces, SSP to) 

ERAP (see error recording analysis procedure) 

error recording analysis procedure 2-220 

error recovery, |/O 2-58 

error utility, procedure 2-274 

example, control flow chart 2-2 

extended character file restore utility 2-380 

extended character file save utility 2-382 

extract, SDDM VTOC 2-134 

extract, Release 3 and Release 4 TDDM 
VTOC 2-157 


F 


F and | specifications (See interactive data 
definition utility) 
file 
build utility 2-280 
copy utility 2-258 
delete utility 2-276 
display utility, history 2-284 
rebuild, IPL 2-16 
rename utility 2-366 
file transfer, SDDM 2-145 
file-to-library copy—record mode 2-305 
file-to-library copy—sector mode 2-308 
file-to-print copy—sector mode 2-306 
Finance subsystem 2-552 
Finance subsystem protocols A-47 
find a library routine 2-176 
find, librarian 2-178 
find, single name 2-177 


Index 
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folder 2-126 
delete utility 2-276 
mail (see DW/36 interfaces, SSP to) 
management services (FMS) 
|/O router 2-127 
utility 2-390 
utility functions 2-130 
rebuild, IPL FMS 2-17 
resource security file, edit for 2-340 
resource security file, list for 2-346 
format-1 area access, active 2-190 
FORTRAN compiler modules and 
execution-time subroutines 
(refer to Appendix B) 
FORTRAN interfaces, SSP to 3-19 


G 


generator utility, screen format 2-370 

get/put, library sector 2-181 

get request processing, disk data 
Management 2-86 

get, source library 2-179 


H 


help utility 2-282 

high-level aids and task-to-task 
communications 2-44 

high-speed disk file to disk file copy 2-269 

high-speed disk file to diskette file/tape file 
copy 2-272 

high-speed diskette/tape file to disk file 
copy 2-270 

history file display utility 2-284 

history file put 2-204 


l-exchange utility, basic exchange and 2-252 


|/O error recovery 2-58 
[/O router (FMS) 2-127 
IDDU (see interactive data definition utility) 
identification file user (see security support) 
ideographic utilities module 
directory C-13, C-16 
ideographic utilities interfaces, SSP to 3-9 
illustration, chart numbering 2-5 
IMS/IRSS subsystem 2-535 
information retrieval 2-208 
initial program load, main storage (see IPL) 
initialization utility, tape 2-374 
initiator 2-64 
initiator command interface 2-61 
initiator support, SDDM 2-138 
inquiry menu option processor 2-48 
Interactive Communications Feature (see 
SSP-ICF) 


interactive data definition utility 2-392 
batch print processing 2-406 
common open 2-411 
copy options 2-412 
data dictionary options processing 2-402 
definition options processing 2-394 
diagnostic diskette copy 2-416 
dictionary rebuild 2-410 
disk file label options processing 2-404 
F and | specification conversion 2-408 
field options processing 2-396 
file definition options processing 2-400 
format options processing 2-398 
WHERE-USED tracking and control 2-415 

interfaces, SSP programming 3-1 

interlocks, system 3-4 

intermodule interfaces, SSP 3-4 

intra subsystem 2-532 

introduction 1-1 

IPL, main storage 2-6 


J 


JCB support, termination 2-172 
job execution 2-79 
job start 2-64 
allocate 2-67 
data communications 2-74 
deallocate 2-72 
normal 2-67 
special 2-70 
initiator 2-64 
open 2-76 
job termination 2-163 
close 2-163 


K 


key, chart symbol 2-4 
keysort 2-114 
keysort utility 2-275 
keys, special 2-52 


labeling and initialization utility, 
diskette 2-286 
LAN, support for 2-492 
abnormal termination 2-502 
controller check 2-500 
initialization/termination task 2-495 
language program products interfaces, 
SSP to 3-10 
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librarian facilities 2-174 
find a library routine 2-176 
librarian find routine 2-178 
library access method routine 2-186 
library member change routine 2-184 
library member delete routine 2-182 
library member protect routine 2-183 
library reallocate routine 2-180 
library record put routine 2-180 
library sector get/put routine 2-181 
single name find routine 2-177 
source library get routine 2-179 
librarian find routine 2-178 
library 
access method 2-186 
condense 2-298 
delete utility 2-276 
file-to-print copy—record mode 2-304 
file-to-print copy—sector mode 2-306 
member change 2-312 
member change routine 2-184 
member delete routine 2-182 
member protect routine 2-183 
reallocate 2-311 
reallocate routine 2-188 
record put routine 2-180 
sector get/put routine 2-181 
to file copy or add—-record mode 2-301 
to file copy—sector mode 2-302 
to library copy—sector mode 2-303 
to print—-sector mode 2-300 
library maintenance utility 2-290 
file-to-library copy—record mode 2-305 
file-to-library copy—sector mode 2-308 
library condense 2-298 
library file-to-print copy—record 


mode 2-304 
library file-to-print copy—sector 
mode 2-306 


library reallocate 2-311 
library-to-file copy or add—record 
mode 2-301 
library-to-file copy—sector mode 2-302 
library-to-library copy—sector mode 2-303 
library-to-print-sector mode 2-300 
member change 2-312 
reader-to-library copy 2-310 
restore #LIBRARY 2-296 
restore a library 2-294 
save a library 2-292 
line protocols, data communications (refer to 
Appendix A) 
link station test 2-472 
list of abbreviations xi 
location, module storage 4-1 
LU type 6.2 (see APPC) 
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M 


macro processor modules (refer to 
Appendix B) 
macro processor interfaces, SSP to 3-20 
magazine drive search, diskette 2-214 
mail log/folder (see DW/36 interfaces, SSP to) 
main storage initial program load (see IPL) 
mainline and router, diagnostics aids 2-216 
mainline TDDM 
level 7.2 2-148 
level 7.3 2-153 
mainline, command processor 2-35 
map, storage (see region map) 
MCR data management 2-119 
membership table, build 2-194 
menu option processor, inquiry 2-48 
message build utility 2-314 
message retrieve 2-197 
miscellaneous service functions 2-190 
MLCA/ELCA (see multiline communications 
attachment support) 
module information, additional 4-1 
module storage location 4-1 
MSRJE (see multiple session remote job entry) 
multiline communications attachment 
support 2-439 
multiple session remote job entry 
support 2-568 
BCS interrupt handler 2-570 
BSC subsystem 2-572 
disk file utility 2-582 
forms control table utility 2-580 
line protocols A-33 
printer/punch 2-578 
reader/console 2-576 
SNA subsystem 2-574 


N 


network resources directory utilities 2-384 

node executive, distributed systems (see 
communications and systems management) 

nonresident program 3-5 

NRD (see network resources directory utilities) 

numbering description, chart 2-5 


O 


OFFICE/36 2-120 
folder management services (FMS) 2-126 
protocols, device support A-14 
interfaces, SSP to 3-25 
profiles processor 2-124 
transforms processor 2-122 
online problem determination 
subfunction 2-248 
open 2-76 
origin point, change 2-206 
overlay linkage editor interfaces, SSP to 3-7 
overview, documentation 1-2 


Index 


X-5 


P region map (continued) 
printer data management 2-94 


password security (see security support) spool writer 2-110 
patch 2-228 SSP-ICF program-to-program 
Peer subsystem 2-554 subsystems 2-529 
personal computer support subsystem work station data management 2-100 
5250 environment 2-608 BSC 3270 interrupt handler 2-586 
environment of the LAN 2-610 BSC 3270 subsystem 3-588 

personalization utility, configuration 2-369 SNA 3270 subsystem 2-592 
phone list (see X.25 utilities) related information, service ix 
pinned program 3-5 Release 4 changes to this manual x 
post utility 2-322 release, work station 2-46 
power-on aid 2-56 remote job entry (see multiple session remote 
preface vii job entry) 
print spooling (see spooling) remote management 2-606 
printer data management 2-94 remote work station support 2-448 
problem management 2-602 exception processing 2-470 
procedure command processing 2-42 get data/save screen 
procedure error utility 2-274 3270 display stations 2-458 
procedure start requests (SSP-ICF) 2-530 5250 display stations 2-457 
profiles processor, office systems 2-124 line protocols A-44 
program attributes 3-5 printer put/get 2-464 
program control 3-5 put data/restore screen 
program start (see procedure start request) 3270 display stations 2-462 
program types 3-4 5250 display stations 2-461 
protect, library member 2-183 vary off 2-467 
protocols, data communication line (refer to varyon 2-455 

Appendix A) rename utility, file 2-366 
protocols, data communications A-1 reorganization utility, disk 2-318 
PS/36 module directory C-21 report writer, SMF 2-240 
PS/36 interfaces, SSP to 3-26 resident program 3-5 
PTF apply/copy 2-237 resolver, cross-reference 2-192 
put, history file 2-204 resource security file (see security support) 
put, library record 2-180 response utility, auto 2-251 
put, library sector 2-181 restore a library 2-294 


restore, diskette data 2-210 
restore, tape data 2-212 
rel retrieval, information 2-208 
retrieve, message 2-197 
reusable program 3-5 
PRG compiler modules and execution-time 
subroutines (refer to Appendix B) 
module directory C-19 RPG interfaces, SSP to 3-10 
interfaces, SSP to 3-25 runtime interface, SDDM 2-140 
queue header area, system 3-3 RWS (see remote work station support) 


Query/36 
data management 2-160 


R S 


reader-to-library copy 2-310 


lib 2-292 
rebuild utility, sector 2-257 Save a library 


save/restore, diskette data 2-210 
stent as Lee pa bad save/restore, tape data 2-212 
repuNe: eee Ne screen design aid program product 
recording transient, service logging 2-242 interfaces, SSP to 3-24 


reentrant program 3-5 screen format generator utility 2-370 
references, directory chart 4-1 SDA module directory C-3 


region map SDA program product interfaces, 


allocate 2-67 
SSP to 3-24 
BSC data management 2-420 SDDM (see distributed data management) 


BSC interrupt handler 2-420 SDLC h date link 
disk data management 2-82 leer syncnnonene Geraint, 


initiator 2-64 
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search, diskette magazine drive 2-214 
sector data management to disk 2-113 
sector rebuild utility 2-257 
security support 2-324 
conversion utility 2-356 
location profile 
edit 2-348 
list 2-350 
modules (non-utility) 2-357 
bind processor 2-360 
change user profile 2-358 
IPL 2-357 
password sign-on 2-359 
resource security check 
1 2-361 
2 2-362 
3 2-363 
4 2-364 
resource security file utilities 2-324 
definition 2-338 
edit 2-340 
edit security for folders and folder 
members 2-352 
list 2-346 
list security for authorization lists 
and folders 2-354 
restore 2-344 
save 2-342 
user identification file utilities 2-324 
definition 2-326 
password change 2-336 
profile edit 2-328 
profile list 2-334 
restore 2-332 
save 2-330 
service logging 2-242 
allocate/terminate 2-243 
recording transient 2-242 
service functions, miscellaneous 2-190 
setdump 2-232 
SEU module directory C-5 
SEU program product interfaces, 
SSP to 3-22 
sign-on 2-37 
single copy program 3-5 
single name find routine 2-177 
SNA 
SNA upline subsystem 2-550 
session protocols A-23, A-53 
to SDLC (see synchronous data link) 
snap dump 2-209 
SNUF 2-550 
soft stop 3-5 
sort utility interfaces, SSP to 3-8 
source DDM (see distributed dta management) 
source entry utility program product 
interfaces, SSP to 3-22 
source library get routine 2-179 
special keys 2-52 
spool file entries utility, display 2-372 
spool file utility, user access to 2-373 


spooling 2-106 
intercept 2-108 
IPL initialization 2-107 
writer 2-110 
SSP 
intermodule interfaces 3-4 
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